Python Interpreter MCP

🚀 Python 解釋器 MCP：一個用於運行腳本的 MCP 服務器

Python 解釋器 MCP 是一個輕量級、實驗性的 MCP 服務器，主要用於在結構化且可重複的環境中執行任意 Python 腳本。它藉助 uv，通過子進程運行隔離的代碼片段，確保腳本執行的獨立性和安全性。

🚀 快速開始

工具介紹

• run_script
  • 功能：使用 uv run script.py 運行給定的腳本。
  • 輸入參數：
    • code(str)：要運行的腳本。
  • 返回結果：腳本的 stdout 輸出。

📦 安裝指南

文檔未提及安裝步驟，暫無法提供。

💻 使用示例

基礎用法

使用 OpenAI 代理 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 執行該腳本，以此確保依賴隔離。
• 最後捕獲腳本的 stdout 輸出，並將其作為響應返回。

⚠️ 使用提示

⚠️ 重要提示

• 該項目可以執行任意 Python 代碼，這意味著它能夠運行包括惡意或破壞性命令在內的任何內容。
• 請僅在受信任且沙箱化的環境中使用此項目。
• 在將此工具與大語言模型（LLM）集成時，務必對輸入進行驗證、設置護欄或限制。

💡 使用建議

由於此項目仍處於開發階段，使用過程中可能會遇到一些問題。建議在使用前仔細閱讀文檔，並在測試環境中進行充分測試。