Jupyter MCP Server for Claude Desktop

Claude Desktop 向け Jupyter MCP サーバー

ローカルインスタンスを含む、あらゆる JupyterLab 環境で実行中の Jupyter ノートブックとのやり取りを可能にする、Model Context Protocol (MCP) サーバーの実装です。macOS、Windows、Linux の Claude Desktop とシームレスに統合できるよう設計されています。

---

🚀 特長

• Jupyter ノートブック向けの MCP サーバーインターフェースを提供します。
• JupyterLab を介したリアルタイムコラボレーションをサポートします。
• Claude Desktop（macOS、Windows、Linux）とスムーズに統合します。
• ノートブックにコードセルやマークダウンセルをプログラムで追加して実行できます。

---

📦 はじめに

✅ 前提条件

以下がインストールされていることを確認してください。

• JupyterLab（バージョン 4.4.1）
• jupyter-collaboration（バージョン 4.0.2）
• ipykernel
• datalayer_pycrdt（バージョン 0.12.15）

🛠 インストール

pip install jupyterlab==4.4.1 jupyter-collaboration==4.0.2 ipykernel
pip uninstall -y pycrdt datalayer_pycrdt
pip install datalayer_pycrdt==0.12.15

---

▶️ JupyterLab の起動

jupyter lab --port 8888 --IdentityProvider.token MY_TOKEN --ip 0.0.0.0

または、次のコマンドも使用できます。

make jupyterlab

--ip 0.0.0.0 を指定すると、Docker 内で実行中の MCP サーバーからアクセスできます。

---

💻 Claude Desktop との統合

Claude Desktop は macOS と Windows で利用できます。Linux ユーザーは、Nix を使った非公式のビルドスクリプトを利用できます。

🔧 設定（macOS / Windows）

{
  "mcpServers": {
    "jupyter": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "-e", "SERVER_URL", "-e", "TOKEN", "-e", "NOTEBOOK_PATH",
        "datalayer/jupyter-mcp-server:latest"
      ],
      "env": {
        "SERVER_URL": "http://host.docker.internal:8888",
        "TOKEN": "MY_TOKEN",
        "NOTEBOOK_PATH": "notebook.ipynb"
      }
    }
  }
}

🔧 設定（Linux）

{
  "mcpServers": {
    "jupyter": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "-e", "SERVER_URL", "-e", "TOKEN", "-e", "NOTEBOOK_PATH", "--network=host",
        "datalayer/jupyter-mcp-server:latest"
      ],
      "env": {
        "SERVER_URL": "http://localhost:8888",
        "TOKEN": "MY_TOKEN",
        "NOTEBOOK_PATH": "notebook.ipynb"
      }
    }
  }
}

SERVER_URL と TOKEN が JupyterLab の設定と一致していることを確認してください。NOTEBOOK_PATH は、JupyterLab の起動ディレクトリからの相対パスです。

---

🛠 利用可能なツール

ツール	説明	入力パラメーター	出力
add_execute_code_cell	ノートブックにコードセルを追加して実行します	cell_content (str)	セルの出力
add_markdown_cell	ノートブックにマークダウンセルを追加します	cell_content (str)	成功メッセージ

---

🐳 Docker イメージのビルド

make build-docker

---

📦 Smithery 経由でのインストール

npx -y @smithery/cli install @datalayer/jupyter-mcp-server --client claude

---

📄 ライセンス

ライセンスの詳細については、リポジトリをご覧ください。

---

🔗 リソース

• 公式リポジトリ： datalayer/jupyter-mcp-server
• MCP プロトコルのドキュメント： modelcontextprotocol.io