Jupyter Notebook MCP

🚀 使用說明

本項目提供了一套集成Jupyter Notebook和Claude Desktop的開發環境，通過WebSocket服務器實現兩者的交互。用戶可以在Claude Desktop中打開Jupyter Notebook文件，並使用外部客戶端進行測試。

🚀 快速開始

安裝依賴

確保你已安裝以下軟件：

• Python 3.x
• pip（用於管理Python包）
• uvicorn（用於啟動WebSocket服務器）

安裝這些依賴可以在終端或命令提示符中運行：

pip install uvicorn websockets jupyter-client python-dotenv

啟動Jupyter Notebook

在終端或命令提示符中啟動Jupyter Notebook：

jupyter notebook

啟動WebSocket服務器

導航到你的項目目錄，然後運行以下命令啟動WebSocket服務器：

uvicorn server:app --reload

這將在http://localhost:8000啟動一個本地服務器。

✨ 主要特性

• 支持Claude Desktop與Jupyter Notebook的集成，方便在Claude Desktop中操作Jupyter Notebook文件。
• 提供外部客戶端測試功能，支持批處理模式。
• 具備一定的問題解決機制，如處理連接超時、端口衝突等問題。

📦 安裝指南

下載與安裝Claude Desktop

訪問官方鏈接下載並安裝Claude Desktop。

配置Claude Desktop

打開Claude Desktop，進入設置菜單：

1. 找到API Settings。
2. 填寫你的API密鑰（如你有）。
3. 點擊保存。

連接Jupyter Notebook

在Claude Desktop中，選擇File > Open，然後選擇你的Jupyter Notebook文件。

💻 使用示例

啟動外部客戶端

運行以下命令啟動外部客戶端：

uv run python src/jupyter_ws_external_client.py

批處理模式

如果你希望以批處理模式運行，可以使用以下命令：

uv run python src/jupyter_ws_external_client.py --batch

📚 詳細文檔

解決問題

連接問題

如果出現連接超時，請嘗試以下步驟：

• 重新啟動WebSocket服務器。
• 檢查端口衝突：默認端口為8765，若被佔用，服務器會自動選擇其他可用端口。

單元格執行問題

確保單元格內容有效且內核正在運行。可以通過以下方式驗證：

1. 點擊Jupyter Notebook中的Kernel菜單。
2. 確保選擇的內核已啟動。

WebSocket端口衝突

如果默認端口8765已被佔用，服務器會自動嘗試其他可用端口。

限制與注意事項

• 僅支持Jupyter Notebook 6.x版本。
• 文本輸出限制為1500字符。
• 不支持高級Jupyter插件交互（如自定義小部件）。
• 連接可能因長時間空閒而超時。

其他資源

受以下項目啟發：

• ihrpr
• Datalayer