Python 解释器 MCP：一个用于运行脚本的 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 集成时，应始终对输入进行验证、设置护栏或限制。