MCP Python Interpreter

基本能力

产品定位

MCP Python Interpreter 是一个开发工具，旨在通过 MCP 协议为 LLMs 提供 Python 环境的交互能力，支持代码执行、文件操作和环境管理。

核心功能

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

适用场景

• 开发者在本地 Python 环境中执行代码或脚本。
• 管理 Python 环境和包依赖。
• 读取和写入文件内容，支持文本和二进制文件。
• 使用预定义的 Python 模板快速生成代码或调试错误。

工具列表

• 环境与包管理：
• list_python_environments：列出所有可用的 Python 环境。
• 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 文件。

常见问题解答

• 安全性：服务严格限制文件操作范围，仅允许在指定工作目录内进行读写，防止越权访问。
• 文件大小限制：支持读取的文件大小上限为 1MB。
• 覆盖保护：写入文件时需要明确指定是否覆盖现有文件。

使用教程

使用依赖

安装 uv 工具（如果未安装）：

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

Windows 用户：

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

安装教程

使用 pip 安装：

pip install mcp-python-interpreter

或使用 uv 安装：

uv install mcp-python-interpreter

调试方式

1. 安装 Claude Desktop。
2. 打开 Claude Desktop，进入菜单 > 设置 > 开发者选项卡，点击“编辑配置”。
3. 在 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
        }
    }
  }
}

1. 重启 Claude Desktop，即可在聊天界面看到 MCP 工具图标。

注意：--dir 参数是必需的，用于指定文件操作的工作目录。

许可证

该项目遵循 Other 开源许可条款，请参阅 Other 了解完整条款。