Python MCP 服务器

一个用于执行 Python 代码并管理 Python 环境的模型上下文协议 (MCP) 服务器。此服务器允许 Claude 和其他大语言模型运行 Python 代码、管理文件，并与 Python 包进行交互。

特性

• 代码执行：运行 Python 代码片段或执行 Python 文件
• 文件管理：列出、读取和写入 Python 文件
• Python 环境：检查 Python 版本和环境信息
• 可配置执行：设置超时时间、工作目录和命令行参数

先决条件

使用此 MCP 服务器之前，请确保安装了以下内容：

• Node.js（版本建议：LTS）
• Python（版本建议：3.6+）

安装指南

克隆仓库

git clone https://github.com/Timtech4u/python-mcp-server.git
cd python-mcp-server

安装依赖

npm install

构建项目

npm run build

配置说明

针对 Claude Desktop 的配置

1. 打开 config.json 文件。
2. 添加以下内容：

   {
     "pythonPath": "C:/Python39/python.exe",
     "nodeModulesDir": "node_modules"
   }
   

3. 保存文件。

针对 Cline 的配置

1. 打开终端，运行命令：

   mcp-config set pythonPath=C:\Python39\python.exe
   

使用方法

示例对话

执行代码

{
  "command": "execute_python_code",
  "params": {
    "code": "print('Hello, World!')",
    "timeout": 30
  }
}

响应：

{
  "output": "Hello, World!\n"
}

执行文件

{
  "command": "execute_python_file",
  "params": {
    "filePath": "./script.py",
    "args": ["arg1", "arg2"]
  }
}

可用工具

执行 Python 代码

• 参数：
  • code（字符串，必填）：要执行的 Python 代码。
  • timeout（数字，可选）：超时时间，默认为 30 秒。

执行 Python 文件

• 参数：
  • filePath（字符串，必填）：要执行的 Python 文件路径。
  • args（数组，可选）：传递给脚本的命令行参数。

故障排除

找不到 Python

如果出现“Python 没有安装”的错误，请确保 Python 已正确安装并添加到系统 PATH 环境变量中。

权限问题

如果遇到权限错误，检查 MCP 服务器运行用户是否有足够的文件访问权限。

超时问题

默认超时时间为 30 秒。如需延长，请在请求中指定 timeout 参数。

许可证

MIT