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_serverVersion: 0.2.2Location: C:\Users\Dell\AppData\Roaming\Python\Python312\site-packagesRequires: 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.1Port: 3306User: rootDatabase: ai_code_ratio2026-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"..."-e- PowerShell 换行使用反引号
`,如果写成单行可以省略换行符。
5. 验证 MCP 连接
添加完成后,使用以下命令查看 MCP 服务状态:
正确输出示例:
Checking MCP server health...[STDIO] mysql: python C:\Users\Dell\AppData\Roaming\Python\Python312\site-packages\mysql_mcp_server\server.py - Connected如果显示
Connected,说明 STDIO MCP 服务已成功启动并被 Qoder CLI 识别。
6. 注意事项
- 路径空格问题:Windows 下路径必须用引号
"..." 包裹。 - 命令分离:STDIO transport 要把可执行程序和脚本分开写,否则 CLI 会尝试将整个字符串当作可执行文件。
- 环境变量:必须使用
-e 将数据库参数传给 MCP server。 - PowerShell 换行
7. 总结
通过以上步骤,你可以在 Windows 上:
- 使用 Qoder CLI STDIO transport 连接 MCP