MCP Python 解释器

一个模型上下文协议（MCP）服务器，允许大型语言模型（LLMs）与Python环境进行交互，读写文件，执行Python代码，并管理开发工作流程。

功能

• 环境管理：列出并使用不同的Python环境（系统和conda）
• 代码执行：在任何可用环境中运行Python代码或脚本
• 包管理：列出已安装的包并安装新的包
• 文件操作：
  • 读取任意类型的文件（文本、源代码、二进制）
  • 写入文本和二进制文件
• Python提示：用于常见Python任务（如函数创建和调试）的模板

安装

你可以使用pip安装MCP Python解释器：

pip install mcp-python-interpreter

或者使用uv：

uv install mcp-python-interpreter

使用Claude Desktop

1. 安装 Claude Desktop
2. 打开Claude Desktop，点击菜单，然后选择设置
3. 转到开发者标签页并点击“编辑配置”
4. 在你的 claude_desktop_config.json 中添加以下内容：

{
  "mcpServers": {
    "mcp-python-interpreter": {
        "command": "uvx",
        "args": [
            "mcp-python-interpreter",
            "--dir",
            "/path/to/your/work/dir",
            "--python-path",
            "/path/to/your/python"
        ],
        "env": {
            "MCP_ALLOW_SYSTEM_ACCESS": 0
        },
    }
  }
}

对于Windows：

{
  "mcpServers": {
    "python-interpreter": {
      "command": "uvx",
      "args": [
        "mcp-python-interpreter",
        "--dir",
        "C:\\path\\to\\your\\working\\directory",
        "--python-path",
        "/path/to/your/python"
      ],
        "env": {
            "MCP_ALLOW_SYSTEM_ACCESS": "0"
        },
    }
  }
}

5. 重启Claude Desktop
6. 你应该现在能在聊天界面看到MCP工具图标

--dir 参数是必需的，它指定了所有文件保存和执行的位置。这有助于通过隔离MCP服务器到特定目录来维护安全性。

先决条件

• 确保你已经安装了uv。如果没有，请使用以下命令安装：

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

• 对于Windows：

  powershell -ExecutionPolicy Bypass -Command "iwr -useb https://astral.sh/uv/install.ps1 | iex"
  

可用工具

Python解释器提供了以下工具：

环境和包管理

• list_python_environments：列出所有可用的Python环境（系统和conda）
• list_installed_packages：列出特定环境中的已安装包
• install_package：在特定环境中安装Python包

代码执行

• run_python_code：在特定环境中执行Python代码
• run_python_file：在特定环境中执行Python文件

文件操作

• read_file：读取任意类型文件的内容，具有大小和安全限制
  • 支持带有语法高亮的文本文件
  • 显示二进制文件的十六进制表示
• write_file：创建或覆盖带有文本或二进制内容的文件
• write_python_file：专门创建或覆盖Python文件
• list_directory：列出目录中的Python文件

可用资源

• python://environments：列出所有可用的Python环境
• python://packages/{env_name}：列出特定环境中的已安装包
• python://file/{file_path}：获取Python文件的内容
• python://directory/{directory_path}：列出目录中的所有Python文件

提示

• python_function_template：生成Python函数的模板
• refactor_python_code：帮助重构Python代码
• debug_python_error：帮助调试Python错误

示例用法

这里有一些例子，说明你可以让Claude使用这个MCP服务器做什么：

• "显示我系统上所有可用的Python环境"
• "在我的conda-base环境中运行这段Python代码：print('Hello, world!')"
• "创建一个名为'hello.py'的新Python文件，其中包含一个说hello的函数"
• "读取我的'data.json'文件的内容"
• "写入一个带有这些设置的新配置文件..."
• "列出我系统Python环境中的所有已安装包"
• "在我的系统Python环境中安装requests包"
• "使用这些参数运行data_analysis.py：--input=data.csv --output=results.csv"

文件处理能力

MCP Python解释器现在支持全面的文件操作：

• 读取文本和二进制文件，最大1MB
• 写入文本和二进制文件
• 源代码文件的语法高亮
• 二进制文件的十六进制表示
• 严格的文件路径安全（仅限于工作目录内）

安全注意事项

此MCP服务器可以访问你的Python环境和文件系统。关键的安全特性包括：

• 隔离的工作目录
• 文件大小限制
• 防止写入工作目录之外
• 显式的覆盖保护

始终谨慎地运行你不完全理解的代码或文件操作。

许可证

MIT