🚀 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 的配置
- 打开
config.json文件。 - 添加以下内容：
{ "pythonPath": "C:/Python39/python.exe", "nodeModulesDir": "node_modules" } - 保存文件。
针对 Cline 的配置
- 打开终端，运行命令：
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 许可证。