🪐 ✨ Jupyter MCP Server

Github-Aktionsstatus PyPI - Version Schmiedeabzeichen

Jupyter MCP Server ist eine Serverimplementierung des Model Context Protocol (MCP), die die Interaktion mit 📓 Jupyter-Notebooks ermöglicht, die in jedem JupyterLab ausgeführt werden (funktioniert auch mit Ihrem 💻 lokalen JupyterLab).

Jupyter MCP Server

Starten Sie JupyterLab

Stellen Sie sicher, dass Sie Folgendes installiert haben. Das Collaboration-Paket wird benötigt, da die am Notebook vorgenommenen Änderungen dank Jupyter Real Time Collaboration sichtbar sind.

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

Starten Sie dann JupyterLab mit dem folgenden Befehl.

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

Sie können auch make jupyterlab ausführen.

[!NOTIZ]
Die --ip wird auf 0.0.0.0 gesetzt, um dem in einem Docker-Container ausgeführten MCP-Server den Zugriff auf Ihr lokales JupyterLab zu ermöglichen.

Related MCP server: Code Summarizer MCP

Verwendung mit Claude Desktop

Claude Desktop kann von dieser Seite für macOS und Windows heruntergeladen werden.

Für Linux hatten wir Erfolg mit diesem inoffiziellen Build-Skript basierend auf 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

Um dies mit Claude Desktop zu verwenden, fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu (lesen Sie mehr auf der MCP-Dokumentationswebsite ).

[!WICHTIG]
Stellen Sie sicher, dass der Port der SERVER_URL und TOKEN mit denen im jupyter lab -Befehl übereinstimmen.
Der NOTEBOOK_PATH sollte relativ zum Verzeichnis sein, in dem JupyterLab gestartet wurde.

Claude-Konfiguration unter macOS und 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" } } } }

Claude-Konfiguration unter Linux

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

Komponenten

Werkzeuge

Der Server bietet derzeit 2 Tools:

add_execute_code_cell

Fügen Sie eine Codezelle in einem Jupyter-Notebook hinzu und führen Sie sie aus.
Eingang:
- cell_content (Zeichenfolge): Auszuführender Code.
Rückgabe: Zellenausgabe.