Jupythunder

🚀 プロジェクト説明

このプロジェクトは、JupyterとMCPサーバーを連携させるためのシステムです。ユーザーは簡単に環境を構築し、Jupyterを通じてMCPサーバーの機能を利用することができます。

🚀 クイックスタート

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

✨ 主な機能

1. MCPサーバー機能
   • JupyterカーネルとMCPクライアント間の通信を処理します。
   • 対話型計算とデータ可視化のためのAPIインターフェースを提供します。
2. Jupyter接続機能
   • Jupyterサーバーに接続し、ユーザーがMCPサーバーの機能を利用できるようにします。

📦 インストール

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

📚 ドキュメント

プロジェクト構造

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サーバーに接続できない問題: 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とトークンが正しいことを確認してください。
• ファイアウォール設定を確認してください。

ノートブックの作成または開くことができない

• 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構文です。
• 設定ファイルはプロジェクトのルートディレクトリに配置する必要があります。

以上の内容は、プロジェクトのインストール、設定、使用、保守などの各方面を網羅しており、ユーザーが環境構築と問題解決をスムーズに行えるようになっています。