Skip to main content
Glama

MCP Python解释器

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

特征

  • 环境管理:列出并使用不同的 Python 环境(系统和 conda)

  • 代码执行:在任何可用环境中运行 Python 代码或脚本

  • 软件包管理:列出已安装的软件包并安装新的软件包

  • 文件操作

    • 读取任何类型的文件(文本、源代码、二进制)

    • 写入文本和二进制文件

  • Python 提示符:用于常见 Python 任务(如函数创建和调试)的模板

Related MCP server: Nash MCP Server

安装

您可以使用 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 }, } } }
  1. 重启Claude桌面

  2. 您现在应该在聊天界面中看到 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 环境和文件系统。主要安全功能包括:

  • 隔离工作目录

  • 文件大小限制

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

  • 显式覆盖保护

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

执照

麻省理工学院

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yzfly/mcp-python-interpreter'

If you have feedback or need assistance with the MCP directory API, please join our Discord server