MCP Python Interpreter

🚀 MCP Python 解释器

MCP Python 解释器是一个 Model Context Protocol (MCP) 服务器，它能让大语言模型（LLM）与 Python 环境进行交互。借助它，用户可以读取和写入文件、执行 Python 代码，还能管理开发工作流程。

🚀 快速开始

使用 MCP Python 解释器前，你需要进行安装，安装完成后可与 Claude Desktop 搭配使用。具体步骤如下：

安装

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

pip install mcp-python-interpreter

或

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 服务器到特定目录来维护安全。

先决条件

• 确保安装了 pip 和 uv
• 确认已安装 Python 解释器

✨ 主要特性

• 环境管理：可列出并使用不同的 Python 环境（系统和 conda），支持多版本 Python 环境，还能自动检测 conda 环境。
• 代码执行：能在任何可用环境中运行 Python 代码或脚本，具备安全的代码沙箱，可限制文件访问权限。
• 包管理：可以列出已安装的包并安装新包，支持通过 pip 和 conda 安装/卸载包。
• 文件操作：
  • 读取任何类型的文件（文本、源代码、二进制），支持文本和二进制文件读取，最大限制 1MB，还具备源代码文件的语法高亮显示和二进制文件的十六进制转义功能。
  • 写入文本和二进制文件，严格控制在工作目录内进行写入操作。
• Python 提示模板：提供常见 Python 任务的模板，如函数创建和调试。

💻 使用示例

基础用法

# 示例 1: 简单计算
result = 2 + 3
print(result)  # 输出 5

# 示例 2: 文件操作
with open("test.txt", "w") as f:
    f.write("Hello, World!")

📚 详细文档

可用工具

• 环境管理：支持多版本 Python 环境，自动检测 conda 环境。
• 代码执行：安全的代码沙箱，限制文件访问权限。
• 包管理：通过 pip 和 conda 安装/卸载包。
• 文件操作：严格控制文件路径，防止恶意写入。

资源

• API 文档：详细说明每个接口的功能和用法。
• 示例代码：提供常见场景的使用案例。
• 问题排查：常见问题及解决方案。

文件处理能力

• 读取文件：支持文本和二进制文件，最大限制 1MB。
• 写入文件：严格控制在工作目录内。
• 语法高亮：源代码文件的高亮显示。
• 十六进制表示：二进制文件的十六进制转义。

🔧 技术细节

此 MCP 服务器对您的 Python 环境和文件系统有访问权限。关键安全功能包括：

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

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

📄 许可证

本项目采用 MIT 许可证。