原创

在 Windows 上使用 Python MCP 配置 Qoder CLI STDIO 服务教程

1. 安装 Python MCP 服务

首先确保你已经安装了 Python（3.12 及以上版本），并且已正确配置环境变量。

打开 PowerShell 或 CMD，执行以下命令安装 Python MCP 及相关依赖：

pip install mysql-mcp-server mysql-connector-python mcp

安装完成后，可以通过 pip show mysql-mcp-server 确认安装路径：

pip show mysql-mcp-server

示例输出：

Name: mysql_mcp_server
Version: 0.2.2
Location: C:\Users\Dell\AppData\Roaming\Python\Python312\site-packages
Requires: mcp, mysql-connector-python

2. 配置环境变量

为了让 MCP 服务可以连接 MySQL 数据库，需要设置数据库相关环境变量：

$env:MYSQL_HOST="127.0.0.1"
$env:MYSQL_PORT="3306"
$env:MYSQL_USER="root"
$env:MYSQL_PASSWORD="root"
$env:MYSQL_DATABASE="ai_code_ratio"

注意：这里的 ai_code_ratio 是你的数据库名称，请根据实际情况修改。

3. 验证 Python MCP 服务

可以在 PowerShell 中直接启动 Python MCP 服务来确认配置是否正确：

python "C:\Users\Dell\AppData\Roaming\Python\Python312\site-packages\mysql_mcp_server\server.py"

输出示例：

Starting MySQL MCP server with config:
Host: 127.0.0.1
Port: 3306
User: root
Database: ai_code_ratio
2026-01-13 15:44:08,916 - mysql_mcp_server - INFO - Starting MySQL MCP server...
2026-01-13 15:44:08,916 - mysql_mcp_server - INFO - Database config: 127.0.0.1/ai_code_ratio as root

这说明 MCP 服务已成功启动，但此时还没有通过 Qoder CLI 注册。

4. 配置 Qoder CLI 连接 STDIO MCP 服务

在 Windows 下，由于路径中可能存在空格，Qoder CLI 的 STDIO transport 需要 把可执行文件和脚本路径分开，并用引号包裹脚本路径。

先移除mcp工具

qodercli mcp remove mysql

在 PowerShell 中执行以下命令：

qodercli mcp add mysql python `
    "C:\Users\Dell\AppData\Roaming\Python\Python312\site-packages\mysql_mcp_server\server.py" `
    -e MYSQL_HOST=127.0.0.1 `
    -e MYSQL_PORT=3306 `
    -e MYSQL_USER=root `
    -e MYSQL_PASSWORD=root `
    -e MYSQL_DATABASE=ai_code_ratio `
    -e MYSQL_SSL=false

说明：

python 是可执行程序

"..." 中是 MCP server 脚本路径

-e 后是数据库连接参数

PowerShell 换行使用反引号 `，如果写成单行可以省略换行符。

5. 验证 MCP 连接

添加完成后，使用以下命令查看 MCP 服务状态：

qodercli mcp list

正确输出示例：

Checking MCP server health...

[STDIO] mysql: python C:\Users\Dell\AppData\Roaming\Python\Python312\site-packages\mysql_mcp_server\server.py - Connected