🪐 ✨ Jupyter MCP Server

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).

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:

1. 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.

2. add_markdown_cell

• Fügen Sie eine Markdown-Zelle in einem Jupyter-Notizbuch hinzu.

• Eingang:

  • cell_content (Zeichenfolge): Markdown-Inhalt.

• Gibt zurück: Erfolgsmeldung.

Gebäude

Sie können das Docker-Image aus der Quelle erstellen.

make build-docker

Installation über Smithery

So installieren Sie den Jupyter MCP Server für Claude Desktop automatisch über Smithery :

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