MCP Python Interpreter

🚀 MCP Python 解釋器

MCP Python 解釋器是一個 Model Context Protocol (MCP) 服務器，它能讓大語言模型（LLM）與 Python 環境進行交互。藉助它，用戶可以讀取和寫入文件、執行 Python 代碼，還能管理開發工作流程。

🚀 快速開始

使用 MCP Python 解釋器前，你需要進行安裝，安裝完成後可與 Claude Desktop 搭配使用。具體步驟如下：

安裝

你可以使用 pip 或 uv 來安裝 MCP Python 解釋器：

pip install mcp-python-interpreter

或

uv install mcp-python-interpreter

與 Claude Desktop 的使用方法

1. 安裝 Claude Desktop
2. 打開 Claude Desktop，點擊菜單，然後選擇設置
3. 轉到開發者選項卡並點擊“編輯配置”
4. 將以下內容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "mcp-python-interpreter": {
        "command": "uvx",
        "args": [
            "mcp-python-interpreter",
            "--dir",
            "/path/to/your/work/dir",
            "--python-path",
            "/path/to/your/python"
        ],
        "env": {
            "MCP_ALLOW_SYSTEM_ACCESS": 0
        },
    }
  }
}

對於 Windows 系統，添加以下內容：

{
  "mcpServers": {
    "python-interpreter": {
      "command": "uvx",
      "args": [
        "mcp-python-interpreter",
        "--dir",
        "C:\\path\\to\\your\\working\\directory",
        "--python-path",
        "/path/to/your/python"
      ],
        "env": {
            "MCP_ALLOW_SYSTEM_ACCESS": 0
        },
    }
  }
}

5. 重啟 Claude Desktop
6. 此時，你應該會在聊天界面看到 MCP 工具圖標

⚠️ 重要提示

--dir 參數是 必需的，它指定了所有文件保存和執行的位置，這有助於通過隔離 MCP 服務器到特定目錄來維護安全。

先決條件

• 確保安裝了 pip 和 uv
• 確認已安裝 Python 解釋器

✨ 主要特性

• 環境管理：可列出並使用不同的 Python 環境（系統和 conda），支持多版本 Python 環境，還能自動檢測 conda 環境。
• 代碼執行：能在任何可用環境中運行 Python 代碼或腳本，具備安全的代碼沙箱，可限制文件訪問權限。
• 包管理：可以列出已安裝的包並安裝新包，支持通過 pip 和 conda 安裝/卸載包。
• 文件操作：
  • 讀取任何類型的文件（文本、源代碼、二進制），支持文本和二進制文件讀取，最大限制 1MB，還具備源代碼文件的語法高亮顯示和二進制文件的十六進制轉義功能。
  • 寫入文本和二進制文件，嚴格控制在工作目錄內進行寫入操作。
• Python 提示模板：提供常見 Python 任務的模板，如函數創建和調試。

💻 使用示例

基礎用法

# 示例 1: 簡單計算
result = 2 + 3
print(result)  # 輸出 5

# 示例 2: 文件操作
with open("test.txt", "w") as f:
    f.write("Hello, World!")

📚 詳細文檔

可用工具

• 環境管理：支持多版本 Python 環境，自動檢測 conda 環境。
• 代碼執行：安全的代碼沙箱，限制文件訪問權限。
• 包管理：通過 pip 和 conda 安裝/卸載包。
• 文件操作：嚴格控制文件路徑，防止惡意寫入。

資源

• API 文檔：詳細說明每個接口的功能和用法。
• 示例代碼：提供常見場景的使用案例。
• 問題排查：常見問題及解決方案。

文件處理能力

• 讀取文件：支持文本和二進制文件，最大限制 1MB。
• 寫入文件：嚴格控制在工作目錄內。
• 語法高亮：源代碼文件的高亮顯示。
• 十六進制表示：二進制文件的十六進制轉義。

🔧 技術細節

此 MCP 服務器對您的 Python 環境和文件系統有訪問權限。關鍵安全功能包括：

• 隔離的工作目錄
• 文件大小限制
• 防止寫入工作目錄之外的位置
• 顯式覆蓋保護

始終謹慎運行不完全理解的代碼或文件操作。

📄 許可證

本項目採用 MIT 許可證。