🪐 ✨ Jupyter MCP-сервер

Jupyter MCP Server — это реализация сервера Model Context Protocol (MCP), которая обеспечивает взаимодействие с 📓 блокнотами Jupyter, работающими в любой JupyterLab (также работает с вашим 💻 локальным JupyterLab).

Запустить 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 , чтобы разрешить серверу MCP, работающему в контейнере Docker, получать доступ к локальному 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 ).

[!ВАЖНЫЙ]

Убедитесь, что порт SERVER_URL и TOKEN совпадают с портами, используемыми в команде jupyter lab .

NOTEBOOK_PATH должен быть указан относительно каталога, в котором был запущен JupyterLab.

Конфигурация Клода на 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

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

Компоненты

Инструменты

В настоящее время сервер предлагает 2 инструмента:

1. add_execute_code_cell

• Добавьте и выполните ячейку кода в блокноте Jupyter.

• Вход:

  • cell_content (строка): Код для выполнения.

• Возвращает: Вывод ячейки.

2. add_markdown_cell

• Добавьте ячейку Markdown в блокнот Jupyter.

• Вход:

  • cell_content (строка): Содержимое Markdown.

• Возвращает: сообщение об успешном выполнении.

Здание

Вы можете собрать образ Docker из исходного кода.

make build-docker

Установка через Smithery

Чтобы автоматически установить Jupyter MCP Server для Claude Desktop через Smithery :

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