在 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

如果显示 Connected，说明 STDIO MCP 服务已成功启动并被 Qoder CLI 识别。

6. 注意事项

7. 总结

通过以上步骤，你可以在 Windows 上：

• 安装 Python MCP 服务
• 配置 MySQL 连接
• 使用 Qoder CLI STDIO transport 连接 MCP
• 通过 Qoder CLI 与数据库交互