mcpField
M
mcp-notebooks

mcp-notebooks

ローカル
github.com/Neuron1c開発ツール076 週間前に更新

mcp-notebooks について

mcp-notebooksは、ノートブックのコードを段階的に実行するMCPサーバーで、実行間もカーネル変数を保持します。LLMを使った探索的データ分析向けですが、現状は危険性があるとREADMEに記載され、Dockerでの隔離が推奨されています。

主な機能

  1. 01ノートブックコードの段階的実行
  2. 02実行間でのカーネル変数の保持
  3. 03Dockerを使ったセットアップ
  4. 04StdIOとSSEの接続方式

活用シーン

  1. 01段階的なコード実行による探索的データ分析
  2. 02複数回の実行で変数を再利用
  3. 03ノートブック実行サーバーをMCPクライアントに接続

MCP 対応

MCPクライアントにノートブック実行機能を提供します。READMEではStdIOまたはSSEでの接続方法を説明し、SSEではsupergatewayを使う構成も記載しています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"notebooks": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"build"
]
}
}
}
起動コマンドdocker run -i --rm build

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocibuild

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

mcp-notebooks

ノートブック実行 MCP サーバー

現状のまま使うのはかなり危険です

理由

すでに存在する他のどんな Python 実行サーバーでもコードを実行できるのに、なぜこれを使うのでしょうか。この MCP サーバーを使えば、LLM が EDA のような形で段階的にコードを実行し、間違いにすばやく対応できます。変数はカーネルに保持され、以降の実行でも使用できます。

Claude のインストール

いいですか、これはワンライナーを実行して Node の何かを動かすだけの手順ではありません。AI の支配者……いえ、Claude からシステムを保護するため、これは本当に Docker 環境で実行してください。では、Docker をインストールして戻ってきてください。

おかえりなさい。まだ DockerHub にはないので、以下のコマンドを実行してください。

git clone [email protected]:Neuron1c/mcp-notebooks.git
cd mcp-notebooks

docker build . -t mcp-notebooks:latest

あと少しです。次の内容を your claude_desktop_config.json に追加してください。

StdIO

{
  "mcpServers": {
    "notebooks": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp-notebooks:latest"
      ]
    }
  }
}

SSE

または手動で実行してください。

docker run -p 3001:3001 mcp-notebooks:latest

次に config.json を設定します。

{
  "mcpServers": {
    "notebooks": {
      "command": "npx",
      "args": [
        "supergateway",
        "--sse",
        "http://localhost:3001/sse"
      ]
    }
  }
}

Python ライブラリの追加

現時点では、プロジェクトの依存関係はサーバーの実行に必要な最低限のものに限定されています。さらに追加するには、まず poetry をインストールする必要があります。手こずったあとは(ヒント:pipx を使ってください)

uv add your-package

追加を推奨するパッケージ

  • numpy
  • pandas
  • scikit-learn
  • matplotlib
  • seaborn

AI は、あなたに何かを実演するときにグラフ描画パッケージを本当によく使おうとすることがわかりました。

TODO

  • ノートブックを表示する
  • 環境をさらにサンドボックス化する
  • データ取り込みのシナリオを考える(Kedro catalog?)
  • 依存性注入(または、ユーザー自身にコンテナを取得してビルドしてもらう)

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。