Python MCP Server

🚀 Python MCP 服务器

Python MCP 服务器是一个用于执行 Python 代码并管理 Python 环境的模型上下文协议 (MCP) 服务器。它允许 Claude 和其他大语言模型运行 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 代码

执行 Python 文件

故障排除

找不到 Python

⚠️ 重要提示

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

权限问题

⚠️ 重要提示

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

超时问题

⚠️ 重要提示

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

📄 许可证

本项目采用 MIT 许可证。