MCP Python 解释器

一个 Model Context Protocol (MCP) 服务器，允许 LLM 与 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 服务器到特定目录来维护安全。

先决条件

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

可用工具

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

资源

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

提示示例

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

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

文件处理能力

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

安全注意事项

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

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

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

许可证

MIT