MCP Python Interpreter

MCP Python解释器

模型上下文协议 (MCP) 服务器允许 LLM 与 Python 环境交互、读取和写入文件、执行 Python 代码以及管理开发工作流程。

特征

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

安装

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

或者使用 uv：

与 Claude Desktop 一起使用

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

对于 Windows：

5. 重启Claude桌面
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 环境中安装请求包”
• “使用以下参数运行 data_analysis.py：--input=data.csv --output=results.csv”

文件处理能力

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

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

安全注意事项

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

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

在运行您不完全理解的代码或文件操作时务必保持谨慎。

执照

麻省理工学院