MCP Python Interpreter

MCP Python Interpreter

一种模型上下文协议（MCP）服务，允许大模型与 Python 环境交互、读取和写入文件、执行 Python 代码以及管理开发工作流。

功能

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

安装

你可以使用 pip 安装 MCP Python Interpreter：

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 Interpreter 提供以下工具：

环境和包管理

• 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 文件，其中包含一个用于问候的函数”
• “读取我的 'data.json' 文件内容”
• “使用这些设置编写一个新的配置文件……”
• “列出我的系统 Python 环境中安装的所有包”
• “在我的系统 Python 环境中安装 requests 包”
• “使用这些参数运行 data_analysis.py：--input=data.csv --output=results.csv”

文件处理能力

MCP Python Interpreter 现在支持全面的文件操作：

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

安全注意事项

此 MCP 服务可以访问你的 Python 环境和文件系统。主要安全功能包括：

• 隔离的工作目录
• 文件大小限制
• 禁止在工作目录之外写入
• 明确的覆盖保护

对于自己不完全理解的代码运行或文件操作，务必谨慎。

许可证

MIT