python-interpreter-mcp: A MCP server to run scripts
2025.04.19
1
PythonPython 脚本执行开发工具开发效率
python-interpreter-mcp 是一个轻量级的实验性 MCP 服务器，旨在在结构化和可复现的环境中执行任意 Python 脚本。它利用 uv 工具通过子进程运行隔离的代码片段。该服务主要用于运行 Python 脚本并返回其输出，适用于开发调试和自动化脚本执行场景。
View on GitHub
Overview
基本能力
产品定位
python-interpreter-mcp 是一个用于执行 Python 脚本的 MCP 服务器，专注于提供轻量级、隔离的脚本执行环境。
核心功能
- 执行任意 Python 脚本并返回输出
- 使用 uv 工具确保依赖隔离
- 自动创建隐藏文件夹保存脚本文件
适用场景
- 开发调试 Python 脚本
- 自动化脚本执行
- 与 OpenAI Agents SDK 或 Claude Desktop 集成
工具列表
run_script- 功能：运行给定的 Python 脚本
- 输入：
code(str) - 要运行的脚本 - 返回：脚本的标准输出
常见问题解答
- 安全性：该服务会执行任意 Python 代码，可能包括恶意或破坏性命令，仅应在受信任的沙盒环境中使用
- 开发状态：项目处于非常早期的开发阶段
使用教程
使用依赖
需要安装 uv 工具：
pip install uv
安装教程
- 克隆项目仓库
- 确保已安装 uv 工具
调试方式
可以通过以下方式测试服务是否正常工作：
# 示例测试代码
async with MCPServerStdio(
params={
"command": "uvx",
"args": ["python-interpreter-mcp"],
}
) as server:
result = await server.run_script(code="print('Hello, World!')")
print(result)
配置方式
与 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"]
}
}