在 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. 注意事项

1. 路径空格问题 ：Windows 下路径必须用引号 "..." 包裹。
2. 命令分离：STDIO transport 要把可执行程序和脚本分开写，否则 CLI 会尝试将整个字符串当作可执行文件。
3. 环境变量 ：必须使用 -e 将数据库参数传给 MCP server。
4. PowerShell 换行 ：可以用反引号 ````` 分行，提高可读性。

---

7. 总结

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

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