MCP Run Python Code

🚀 mcp-run-python-code

这是一个Python解释器MCP服务器，无需API密钥，免费使用，可直接运行Python代码并获取结果。

🚀 快速开始

本MCP服务器提供了运行Python代码、安装包和执行Python文件的工具。它可以轻松地与MCP客户端集成，包括Claude和其他支持MCP协议的大语言模型应用程序。

✨ 主要特性

• 在安全的环境中执行Python代码。
• 使用pip安装Python包。
• 将Python代码保存到文件并运行。
• 运行现有的Python文件。
• 从执行的代码中返回特定变量的值。
• 支持错误处理和调试。

📦 安装指南

从pip安装

你可以使用uv来安装MCP Run Python Code Server：

uv pip install mcp-run-python-code

或者使用pip：

pip install mcp-run-python-code

从源代码安装

git clone https://github.com/shibing624/mcp-run-python-code.git
cd mcp-run-python-code
pip install -e .

💻 使用示例

基础用法

from run_python_code import RunPythonCode

tool = RunPythonCode(base_dir='/tmp/tmp_run_code/')

# 示例1：基本代码执行
result = tool.run_python_code("x = 10\ny = 20\nz = x * y", "z")
print(f"结果: {result}")  # 输出: 结果: 200

# 示例2：保存并运行文件
result = tool.save_to_file_and_run(
    file_name="calc.py",
    code="a = 5\nb = 15\nc = a + b",
    variable_to_return="c"
)
print(f"结果: {result}")  # 输出: 结果: 20

# 实例3：安装python包
result = tool.pip_install_package("requests")
print(f"结果: {result}")

作为独立的MCP服务器运行

使用标准输入输出传输运行服务器：

uvx mcp-run-python-code

或者

uv run mcp-run-python-code

或者

python -m mcp-run-python-code

然后，你可以将该服务器与任何支持标准输入输出传输的MCP客户端一起使用。

与Cursor集成

要将天气MCP服务器添加到Cursor，请使用以下命令添加标准输入输出MCP：

uvx mcp-run-python-code

可用工具

• run_python_code - 执行Python代码并可选择返回变量值。
• save_to_file_and_run - 将Python代码保存到文件并执行。
• pip_install_package - 使用pip安装Python包。
• run_python_file - 运行现有的Python文件并可选择返回变量值。

高级用法

示例1：基本代码执行

from run_python_code import RunPythonCode
tool = RunPythonCode(base_dir='/tmp/tmp_run_code/')
# Execute simple calculations
code = "result = 2 ** 10"
value = tool.run_python_code(code, "result")
print(value)  # Output: 1024

示例2：运行Python文件

from run_python_code import RunPythonCode
tool = RunPythonCode(base_dir='/tmp/tmp_run_code/')
# Save code to a file and run it
script_code = """
def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

result = fibonacci(10)
print(f"Fibonacci(10) = {result}")
"""
result = tool.save_to_file_and_run("fib.py", script_code, "result")
print(result)  # Output: 55

示例3：数据处理

from run_python_code import RunPythonCode
tool = RunPythonCode(base_dir='/tmp/tmp_run_code/')
# JSON data processing
code = """
import json
data = {'name': '张三', 'age': 30}
json_str = json.dumps(data, ensure_ascii=False)
"""
result = tool.run_python_code(code, "json_str")
print(result)  # Output: {"name": "张三", "age": 30}

📚 详细文档

联系我们

• 问题反馈和建议：
• 邮箱：xuming624@qq.com
• 微信：添加我（微信号：xuming624），验证消息为："姓名-公司-NLP"，加入我们的NLP讨论群。

📄 许可证

本项目遵循 Apache License 2.0，可自由用于商业目的。请在产品描述中包含mcp-run-python-code项目的链接和许可证信息。

🌟 贡献代码

我们欢迎对本项目进行贡献！在提交拉取请求之前，请：

1. 在tests目录中添加适当的单元测试。
2. 运行python -m pytest以确保所有测试都通过。
3. 提交包含清晰变更描述的PR。

👏 致谢

• 基于 MCP Python SDK 构建。