🪐 ✨ Jupyter MCP サーバー

Githubアクションステータス PyPI - バージョン鍛冶屋のバッジ

Jupyter MCP サーバーは、任意の JupyterLab で実行されている 📓 Jupyter ノートブックとのやり取りを提供するモデルコンテキストプロトコル(MCP) サーバー実装です (💻 ローカル JupyterLab でも動作します)。

Jupyter MCP サーバー

JupyterLabを起動する

以下のパッケージがインストールされていることを確認してください。Jupyter Real Time Collaborationにより、ノートブックに加えられた変更内容を確認できるため、コラボレーションパッケージが必要です。

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

次に、以下のコマンドでJupyterLabを起動します。

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

make jupyterlabを実行することもできます。

[！注記]
--ipは0.0.0.0に設定され、Docker コンテナで実行されている MCP サーバーがローカルの JupyterLab にアクセスできるようになります。

Related MCP server: Code Summarizer MCP

Claude Desktop で使用する

Claude Desktop は、macOS および Windows 向けにこのページからダウンロードできます。

Linuxでは、 nixベースのこの非公式ビルドスクリプトを使用することで成功しました。

# ⚠️ UNOFFICIAL # You can also run `make claude-linux` NIXPKGS_ALLOW_UNFREE=1 nix run github:k3d3/claude-desktop-linux-flake \ --impure \ --extra-experimental-features flakes \ --extra-experimental-features nix-command

これを Claude Desktop で使用するには、 claude_desktop_config.jsonに次のコードを追加します (詳細については、 MCP ドキュメント Web サイトを参照してください)。

[！重要]
SERVER_URLとTOKENのポートが、 jupyter labコマンドで使用されているポートと一致していることを確認します。
NOTEBOOK_PATHは、JupyterLab が起動されたディレクトリを基準にする必要があります。

macOSとWindowsでのClaudeの構成

{ "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でのClaudeの設定

CLAUDE_CONFIG=${HOME}/.config/Claude/claude_desktop_config.json cat <<EOF > $CLAUDE_CONFIG { "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" } } } } EOF cat $CLAUDE_CONFIG