Python REPL

🚀 Python 本地 MCP 服務器

Python 本地 MCP 服務器提供了一個交互式的 Python REPL（讀取 - 評估 - 打印循環）環境，讓用戶能便捷地執行 Python 代碼並查看歷史會話。

✨ 主要特性

資源

該服務器支持訪問 REPL 會話歷史，具體如下：

• 採用自定義的 repl:// URI 方案，方便訪問會話歷史。
• 每個會話的歷史能以純文本資源形式查看。
• 歷史記錄會展示每個執行的輸入代碼及其對應的輸出。

工具

服務器實現了 python_repl 工具，用於在持久會話中執行 Python 代碼，具備以下特點：

• 接收 code（待執行的 Python 代碼）和 session_id（必需參數）。
• 為每個會話維護獨立狀態。
• 支持表達式和語句。
• 捕獲並返回 stdout/stderr 輸出。

📦 安裝指南

應用內部

• 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 服務器通過 stdio 運行，調試可能存在一定挑戰。為獲得最佳調試體驗，強烈推薦使用 MCP Inspector。

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

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

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