Jupythunder

🚀 項目說明

本項目主要實現了Jupyter與MCP服務器的連接，處理Jupyter內核與MCP客戶端之間的通信，同時提供API接口用於交互式計算和數據可視化，幫助用戶更便捷地進行相關操作。

🚀 快速開始

MCP服務器啟動

conda activate jupythunder
cd jupythunder
python jupythunder_server.py --port 8000

Jupyter連接測試

conda activate jupythunder
cd jupythunder
python jupythunder_client.py --connect http://localhost:8000

📦 安裝指南

MCP服務器配置

conda create -n jupythunder python>=3.7
conda activate jupythunder
pip install mcp[cli] requests websocket-client python-dotenv urllib3
git clone https://github.com/yourusername/jupythunder.git
cd jupythunder
python jupythunder_server.py --port 8000

Jupyter連接配置

conda create -n jupythunder python>=3.7
conda activate jupythunder
pip install requests websocket-client python-dotenv urllib3
git clone https://github.com/yourusername/jupythunder.git
cd jupythunder
python jupythunder_client.py --connect http://localhost:8000

📚 詳細文檔

使用說明

MCP服務器功能

1. 處理Jupyter內核與MCP客戶端之間的通信。
2. 提供API接口用於交互式計算和數據可視化。

Jupyter連接步驟

1. 啟動Jupyter服務器並獲取token。
2. 配置jupythunder_client.py中的連接參數。
3. 運行客戶端以建立連接。

項目結構

jupythunder/
├── jupythunder_server.py          # MCP服務器實現
├── jupythunder_client.py          # Jupyter API客戶端
├── tools.py                       # MCP工具實現
├── utils.py                       # 工具函數
└── requirements.txt               # 項目依賴

詳細配置

環境變量設置

export JUPYTHUNDER_PORT=8000
export JUPYTHUNDER_LOG_LEVEL=DEBUG

配置文件示例

# jupythunder_config.py
JUPYTHUNDER_HOST = "localhost"
JUPYTHUNDER_PORT = 8000
LOG_LEVEL = "INFO"

常見問題

無法連接到MCP服務器jupythunder: spawn pythonENOENT

此錯誤表示找不到Python可執行文件。請檢查以下配置：

1. 使用絕對路徑指定Python：

   {
     "mcpServers": {
       "jupythunder": {
         "command": "/absolute/path/python",
         "args": ["/absolute/path/jupythunder_server.py"]
       }
     }
   }
   

   確認Python安裝位置：

   which python  # macOS/Linux
   where python  # Windows
   

2. 使用python3命令：

   {
     "mcpServers": {
       "jupythunder": {
         "command": "python3",
         "args": ["/absolute/path/jupythunder_server.py"]
       }
     }
   }
   

問題排查

Jupyter連接失敗

• 確認Jupyter服務器正在運行
• 檢查提供的URL和token是否正確
• 查看防火牆設置

創建或打開筆記本失敗

• 確認在Jupyter服務器上有寫入權限
• 檢查筆記本名稱中不含特殊字符
• 確認沒有同名的筆記本已存在

項目組件

1. FastMCP服務器：實現高效的計算任務處理。
2. Jupyter客戶端：提供用戶交互界面和API調用。
3. 工具集：包含數據處理、日誌記錄等功能。

依賴管理

安裝要求

• Python >=3.7
• conda環境管理器

第三方庫

• mcp[cli]
• requests
• websocket-client
• python-dotenv
• urllib3

日誌系統

conda activate jupythunder
cd jupythunder
python logging_server.py --port 8001

擴展模塊

自定義內核支持

conda install -n jupythunder custom-kernel

額外功能包

pip install extra_features

附錄

命令行參數

• --port：指定服務器端口，默認8000。
• --log-level：設置日誌級別，可選DEBUG/INFO/ERROR。

錯誤代碼

補充說明

• 所有代碼示例均為Python語法。
• 配置文件需放置在項目根目錄下。

以上內容涵蓋了項目的安裝、配置、使用及維護等各個方面，確保用戶能夠順利完成環境搭建和問題解決。