Skip to main content
Glama

af-jupyterlab-mcp

MCPサーバー。AFユーザーが、UChicago ATLAS Analysis Facility Kubernetesクラスター上に、自分専用のJupyterLabサーバーを作成・確認・削除できるようにします。これは、af-portalが現在デプロイしているものと同じノートブックを、LLM向けのツールとして公開するものです。

アーキテクチャ

LLM <--MCP/HTTP--> af-jupyterlab-mcp <--k8s API--> notebook namespace (Pod/Service/Secret/Ingress)
                         ^
                         | Authorization: Bearer <broker-issued JWT>
                         |
              af-mcp-platform credential broker

フェーズ1(このリポジトリ、現在)では、ノートブックのPod/Service/Secret/Ingressの4点セットを管理する6つのツールを提供します。これらは、af-portalのportal/jupyterlab.pyと、その4つのJinjaテンプレートから移植されたものです。フェーズ2(追跡中、未構築)では、ノートブック内部で動作するDatalayer jupyter-mcp-serverへの型付きプロキシを追加する予定です。詳細は、maniaclab/af-mcp-platform#189を参照してください。

Related MCP server: rucio-mcp

プロジェクト構成

src/af_jupyterlab_mcp/
├── cli.py               # argparse: `af-jupyterlab-mcp serve` (HTTP only)
├── config.py            # env-driven Settings: namespace, domain, image allowlist, quotas
├── server.py            # FastMCP setup, lifespan (k8s client + broker verifier), tool registration
├── auth/
│   └── broker.py        # extract_bearer(), get_broker_claims() -- broker-issued JWT verification
├── k8s/
│   ├── errors.py         # GuardrailError, NameConflictError, NotFoundOrNotYoursError, ...
│   ├── guardrails.py     # CPU/memory/duration range + image allowlist validation
│   ├── names.py          # sanitize_k8s_pod_name, name availability, name generation
│   ├── templates.py      # Jinja rendering of the four ported manifests
│   ├── notebooks.py      # create/get/list/delete notebook (ported portal logic)
│   ├── gpu.py            # get_gpu_availability (ported portal logic)
│   └── templates/        # pod.yaml.j2, service.yaml.j2, secret.yaml.j2, ingress.yaml.j2
│                          # (ported verbatim from af-portal/portal/templates/jupyterlab/)
└── tools/
    └── jupyterlab.py     # the six @mcp.tool() functions

ツールの一覧

  • create_jupyter_server

  • list_jupyter_servers

  • get_jupyter_server

  • delete_jupyter_server

  • get_gpu_availability

  • list_supported_images

各サーバーの所有者は常に、検証済みブローカーJWTのclaims.unixnameです。所有者やユーザー名を引数に取るツールはありません。

ビルドおよびテストコマンド

pixi run test          # quick tests
pixi run lint          # pre-commit + pylint
pixi run helm-lint      # lint + smoke-render the Helm chart

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      C
      maintenance
      An MCP server that enables LLMs to execute Python code on GPU-accelerated compute nodes within SLURM-managed HPC environments. It bridges local clients to remote clusters by launching JupyterLab sessions via SLURM jobs to facilitate high-performance notebook-based computation.
      7
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that exposes Rucio distributed data management operations as tools for LLMs. Designed for ATLAS physicists working with grid data on analysis facilities, but usable with any Rucio instance.
      6
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      Enables code execution in isolated Docker containers with persistent IPython, Node.js, or R kernels, supporting file import/export and cross-session transfers via MCP tools.
      6
      MIT