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 环境和文件系统。主要安全功能包括：

• 隔离工作目录

• 文件大小限制

• 防止在工作目录之外写入

• 显式覆盖保护

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

执照

麻省理工学院