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 構建。