安全本地 Python 执行器

一个 MCP 服务器（stdio 传输），它封装了 Hugging Face 的 LocalPythonExecutor （来自 smolagents 框架）。它是一个自定义的 Python 运行时， 在本地运行由 LLM 生成的 Python 代码时，提供基本的隔离/安全性。它不需要 Docker 或 VM。 此软件包允许通过 MCP（模型上下文协议）将 Python 执行器公开为 LLM 应用程序（如 Claude Desktop、Cursor 或任何其他 MCP 兼容客户端）的工具。 对于 Claude Desktop，此工具是一种简单的方法来添加缺失的代码解释器（ChatGPT 中已经作为插件提供了一段时间）。

<img width="1032" alt="image" src="https://github.com/user-attachments/assets/3b820bfc-970a-4315-8f2d-970591c6fdae" />

特性

• 公开 run_python 工具
• 与直接使用 Python eva()l 相比，更安全地执行 Python 代码
• 通过 uv 在 Python venv 中运行
• 不允许文件 I/O 操作
• 受限制的导入列表
  • collections
  • datetime
  • itertools
  • math
  • queue
  • random
  • re
  • stat
  • statistics
  • time
  • unicodedata

安全性

小心在您的机器上执行由 LLM 生成的代码，远离通过命令行或使用 eval() 运行 Python 的 MCP 服务器。最安全的选择是使用 VM 或 Docker 容器，但这需要一些设置工作，消耗资源/速度较慢。有一些第三方服务提供 Python 运行时，但它们需要注册、API 密钥等。

LocalPythonExecutor 在直接使用本地 Python 环境（更容易设置）和在 Docker 容器或 VM/第三方服务中远程执行（更安全）之间提供了良好的平衡。Hugginng Face 团队投入了时间来创建一个快速且安全的选项来运行其代码代理使用的 LLM 生成的代码。此 MCP 服务器基于它构建：

为了增加第一层安全性，smolagents 中的代码执行不是由原始 Python 解释器执行的。我们从头开始重建了一个更安全的 LocalPythonExecutor。

阅读更多 here。

安装和执行

1. 安装 uv（例如，macOS 上使用 brew install uv 或使用 官方文档）
2. 克隆存储库，更改目录 cd mcp_safe_local_python_executor
3. 可以通过命令行 uv run mcp_server.py 启动服务器，venv 将自动创建，依赖项（smollagents, mcp）将被安装

配置 Claude Desktop

1. 确保您已安装 Claude for Desktop（从 claude.ai 下载）

2. 编辑您的 Claude for Desktop 配置文件：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • 或者打开 Claude Desktop -> Settings -> Developer -> 点击 "Edit Config" 按钮

3. 添加以下配置：

{
    "mcpServers": {
        "safe-local-python-executor": {
            "command": "uv",
            "args": [
                "--directory", 
                "/path/to/mcp_local_python_executor/",
                "run",
                "mcp_server.py"
            ]
        }
    }
}

4. 重启 Claude for Desktop
5. Python 执行器工具现在将在 Claude 中可用（您将在消息输入字段中看到锤子图标）

示例提示

配置完成后，您可以使用如下提示：

• "使用 Python 计算 5 的阶乘"
• "创建一个高达 100 的素数列表"
• "解这个方程（使用 Python）：x^2 + 5x + 6 = 0"

开发

克隆存储库。使用 uv 创建 venv，安装开发依赖项，运行测试：

uv venv .venv
uv sync --group dev
python -m pytest tests/

---

<a href="https://glama.ai/mcp/servers/@maxim-saplin/mcp_safe_local_python_executor"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@maxim-saplin/mcp_safe_local_python_executor/badge" /> </a>