mcpField
P
Python Interpreter Mcp

Python Interpreter Mcp

本地服务
github.com/bimalpaudels开发工具179 周前更新

关于 Python Interpreter Mcp

Python Interpreter Mcp 是一款实验性 MCP 服务,用于运行客户端提供的 Python 脚本。它通过 uv 在隔离的子进程中执行脚本,并返回标准输出。

主要功能

  1. 01将提供的 Python 代码作为脚本运行
  2. 02使用 uv 执行脚本
  3. 03捕获并返回标准输出

适用场景

  1. 01在 LLM 工作流中运行 Python 代码片段
  2. 02收集脚本输出供后续步骤使用

MCP 相关

它向 MCP 客户端提供 `run_script` 工具,接收代码并返回脚本的标准输出。服务可通过 stdio 启动。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"python-interpreter": {
"command": "uvx",
"args": [
"python-interpreter-mcp"
]
}
}
}
启动命令uvx python-interpreter-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypipython-interpreter-mcp

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

python-interpreter-mcp:用于运行脚本的 MCP 服务

概述

这是一个轻量级的实验性 MCP 服务,旨在结构化且可复现的环境中执行任意 Python 脚本。它借助 uv 通过子进程运行隔离的代码片段。

工具
  • run_script
    • 使用 uv run script.py 运行给定脚本。
    • 输入:
      • code(str):要运行的脚本
    • 返回:给定脚本的标准输出。

配置

与 OpenAI Agents 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 执行脚本,以确保依赖隔离。
  • 捕获脚本的标准输出并将其作为响应返回。

使用警告

此项目仍处于非常早期的开发阶段。

⚠️ 重要说明
  • 此工具会执行任意 Python 代码,这意味着它可以运行任何内容,包括恶意或破坏性命令。
  • 仅在可信的沙盒环境中使用。
  • 将其接入大模型时,务必验证、设置防护措施或限制输入。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。