MCP Server Jupyter

🚀 mcp-server-jupyter サーバー

Jupyterノートブックを管理および対話的に操作するためのMCPサーバーで、ノートブックのプログラムによる管理を実現します。

🚀 クイックスタート

このサーバーを使用することで、Jupyterノートブックの様々な操作をプログラムで行うことができます。以下に、主な機能と使用方法を説明します。

✨ 主な機能

ツール

このサーバーは、ノートブックの操作に6種類のツールを提供しています。

1. 出力を含むノートブック内容の読み取り：ノートブックの内容を、セルの出力を含めて読み取ります。

   • 必須パラメータ：notebook_path（文字列）

2. ソースコードのみのノートブック内容の読み取り：出力を含めずにノートブックの内容を読み取ります。

   • サイズ制限で完全なノートブックを読み取れない場合に適しています。
   • 必須パラメータ：notebook_path（文字列）

3. 特定セルの出力の読み取り：指定したセルの出力内容を取得します。

   • 必須パラメータ：
     • notebook_path（文字列）
     • cell_id（文字列）

4. 新しいセルの追加：ノートブックに新しいセルを追加します。

   • 必須パラメータ：
     • notebook_path（文字列）
     • source（文字列）
   • オプションパラメータ：
     • cell_type（文字列）："code" または "markdown"
     • position（整数）：挿入位置（-1 は追加を意味します）

5. セル内容の編集：指定したセルの内容を変更します。

   • 必須パラメータ：
     • notebook_path（文字列）
     • cell_id（文字列）：一意の識別子
     • source（文字列）

6. 特定セルの実行：指定したセルを実行し、出力結果を返します。

   • セルの実行と出力の検証に適しています。
   • 必須パラメータ：
     • notebook_path（文字列）
     • cell_id（文字列）

📦 インストール

Claude Desktop との連携

ステップ1：JupyterLabまたはJupyter Notebookの起動

仮想環境とパッケージのインストールを簡単に管理するために、uvを使用してJupyterノートブックを実行することをおすすめします。

詳細は uvのJupyterドキュメント を参照してください。

uv venv --seed
source .venv/bin/activate
uv pip install jupyterlab
.venv/bin/jupyter lab

注意：この環境は、MCPサーバーで UV_PROJECT_ENVIRONMENT 環境変数として使用する必要があります（次のステップ）。同じディレクトリで実行することを確認してください。

echo $(pwd)/.venv

ステップ2：Claude Desktopの設定

以下の設定をClaude Desktopの設定ファイルに追加してください。

PyPiパッケージのインストール方法：

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "Jupyter-notebook-manager": {
      "command": "uv",
      "args": ["run", "--with", "mcp-server-jupyter", "mcp-server-jupyter"],
      "env": {
        "UV_PROJECT_ENVIRONMENT": "/path/to/venv_for_jupyter/.venv"
      }
    }
  }
}

Gitリポジトリのクローン方法：

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "Jupyter-notebook-manager": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/Users/inna/mcp-server-jupyter/src/mcp_server_jupyter",
        "mcp-server-jupyter"
      ],
      "env": {
        "UV_PROJECT_ENVIRONMENT": "/path/to/venv_for_jupyter/.venv"
      }
    }
  }
}

ステップ3：使用方法

• JupyterLabまたはJupyter Notebookのインスタンスを起動します。
• MCPサーバーを設定する際に、UV_PROJECT_ENVIRONMENT 環境変数を正しく設定することを確認してください。
• プロジェクトディレクトリに関連する依存関係を追加します。

uv pip install mcp-server-jupyter

⚠️ 重要提示

ノートブックを変更した後は、変更を適用するためにページを再読み込みしてください。

Jupyterインスタンスが実行中であることを確認してください。そうしないと、MCPサーバーを引き続き使用できません。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細については LICENSE ファイルを参照してください。