Python MCP

🚀 本地 Python MCP 服務器

這是一個 MCP 服務器，它能提供交互式的 Python 命令行環境（讀取 - 評估 - 打印循環），為用戶帶來便捷的 Python 代碼執行體驗。

✨ 主要特性

🔍 資源

• 服務器允許訪問 REPL 會話歷史記錄。
  • 採用自定義的 repl:// URI 方案來訪問會話歷史。
  • 每個會話的歷史都能以純文本資源的形式查看。
  • 歷史記錄會顯示每個執行的輸入代碼及其對應的輸出。

🛠️ 工具

• 服務器實現了 python_repl 工具，用於在持久會話中執行 Python 代碼。
  • 該工具需要 code（要執行的 Python 代碼）和 session_id 作為必填參數。
  • 每個會話都維護獨立的狀態。
  • 支持表達式和語句的執行。
  • 能夠捕獲並返回 stdout/stderr 輸出。

📦 安裝指南

Claude Desktop

• MacOS：配置文件位於 ~/Library/Application\ Support/Claude/claude_desktop_config.json。
• Windows：配置文件位於 %APPDATA%/Claude/claude_desktop_config.json%。

📚 詳細文檔

👷 構建與發佈

若要準備分發包，可按以下步驟操作：

1. 同步依賴項並更新鎖定文件：

uv sync

2. 構建包發行版：

uv build

執行上述命令後，會在 dist/ 目錄中創建源代碼和輪格式發行版。 3. 發佈到 PyPI：

uv publish

⚠️ 重要提示：你需要通過環境變量或命令行參數設置 PyPI 憑據： - 可以使用令牌：--token 或 UV_PUBLISH_TOKEN。 - 或者使用用戶名/密碼：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD。

🐞 調試

由於 MCP 服務器通過標準輸入輸出運行，調試可能具有一定挑戰性。為了獲得最佳調試體驗，我們強烈推薦使用 MCP Inspector。

你可以通過 npm 使用以下命令啟動 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /path/to/python_local run python-local

啟動後，Inspector 會顯示一個 URL，你可以在瀏覽器中訪問該 URL 開始調試。