Python Interpreter MCP

🚀 Python 解释器 MCP：一个用于运行脚本的 MCP 服务器

Python 解释器 MCP 是一个轻量级、实验性的 MCP 服务器，主要用于在结构化且可重复的环境中执行任意 Python 脚本。它借助 uv，通过子进程运行隔离的代码片段，确保脚本执行的独立性和安全性。

🚀 快速开始

工具介绍

• run_script
  • 功能：使用 uv run script.py 运行给定的脚本。
  • 输入参数：
    • code(str)：要运行的脚本。
  • 返回结果：脚本的 stdout 输出。

📦 安装指南

文档未提及安装步骤，暂无法提供。

💻 使用示例

基础用法

使用 OpenAI 代理 SDK

async with MCPServerStdio(
            params={
                "command": "uvx",
                "args": ["python-interpreter-mcp"],
            }
    ) as server
...

使用 Claude Desktop

在你的 claude_desktop_config.json 中添加以下内容：

"mcpServers": {
  "interpreter": {
    "command": "uvx",
    "args": ["python-interpreter-mcp"]
  }
}

🔧 技术细节

工作原理

• 当 MCP 收到脚本字符串后，会调用 run_script 工具来处理该脚本。
• 它会在当前工作目录中创建一个隐藏文件夹，并将脚本保存为其中的 .py 文件。
• 接着使用 uv run 执行该脚本，以此确保依赖隔离。
• 最后捕获脚本的 stdout 输出，并将其作为响应返回。

⚠️ 使用提示

⚠️ 重要提示

• 该项目可以执行任意 Python 代码，这意味着它能够运行包括恶意或破坏性命令在内的任何内容。
• 请仅在受信任且沙箱化的环境中使用此项目。
• 在将此工具与大语言模型（LLM）集成时，务必对输入进行验证、设置护栏或限制。

💡 使用建议

由于此项目仍处于开发阶段，使用过程中可能会遇到一些问题。建议在使用前仔细阅读文档，并在测试环境中进行充分测试。