Python MCP Server

🚀 Python MCP 服务器

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

🚀 快速开始

Python MCP 服务器为大语言模型提供了与 Python 环境交互的能力。在使用前，需要完成一系列准备工作，包括安装先决条件、克隆仓库、安装依赖、构建项目以及进行相应配置。

✨ 主要特性

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

📦 安装指南

克隆仓库

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