当前位置:首页>python>在 Windows 上使用 Python MCP 配置 Qoder CLI STDIO 服务教程

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

  • 2026-10-19 19:12:40
在 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_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
     是可执行程序
  • "..."
     中是 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 与数据库交互

最新文章

随机文章