FastMCP server for surgical queries against a vault knowledge graph (NetworkX no

graph-query-mcp

Obsidian／Vault のナレッジグラフを対象に、的を絞ったクエリを実行します。起動時に graph.json（NetworkX の node-link 形式）を一度読み込み、Claude に 5 万行のグラフレポートを読ませることなく、対象を絞った質問に回答します。

graphify（ai-brain-starter のグラフ構築スキル）との併用を想定していますが、このサーバーは NetworkX の node-link JSON 形式のグラフであれば、どれでも受け付けます。最大 2 つのスコープ（プライマリ＋セカンダリ。例：個人用＋チーム用）に対応しています。

使う理由

すでに Vault で graphify を実行していれば、graph.json と GRAPH_REPORT.md が生成されています。レポート全体を Claude に読み込ませると、質問のたびに数千トークンを消費します。この MCP は起動時にグラフを一度読み込み、50 ミリ秒未満で回答し、グラフ全体をコンテキストに出力することもありません。

ツール

スコープのデフォルトは personal です。2 つ目のグラフには、scope="onde"（または設定したセカンダリスコープ名）を渡してください。

設定

環境変数は 2 つあり、どちらも省略可能です。

ONDE_GRAPH_JSON_PATH も、SECONDARY_GRAPH_JSON_PATH の下位互換エイリアスとして使用できます。

起動時にパスが存在しない場合、サーバーは警告をログに記録し、そのスコープにクエリが送られるとツールはわかりやすいエラーを返します。サーバーはそのまま起動します。セカンダリグラフが見つからなくても、プライマリグラフの利用は妨げられません。

インストール

Claude Code を開き、次の内容を貼り付けます。

/plugin marketplace add adelaidasofia/graph-query-mcp
/plugin install graph-query-mcp@graph-query-mcp

git clone https://github.com/adelaidasofia/graph-query-mcp.git ~/.claude/graph-query-mcp
cd ~/.claude/graph-query-mcp
pip3 install --break-system-packages -r requirements.txt

{
  "mcpServers": {
    "graph-query": {
      "type": "stdio",
      "command": "fastmcp",
      "args": ["run", "/Users/YOU/.claude/graph-query-mcp/server.py"],
      "env": {
        "GRAPH_JSON_PATH": "/path/to/your/vault/Meta/graphify-out/graph.json"
      }
    }
  }
}

この MCP はグラフを構築するのではなく、グラフに対してクエリを実行します。graph.json をボルトから生成するには、graphify（ai-brain-starter のスキル）を使用するか、NetworkX 互換のほかのビルダーを使用してください。想定される形式は、networkx.node_link_data(G) の出力です。

検証

python3 tests/integration/test_smoke.py
# expected: PASSED — graph-query-mcp smoke (4 steps green)

アーキテクチャ

FastMCP、stdio トランスポート、Python 3.10 以降を使用します。グラフは起動時に一度だけ読み込まれ、メモリにキャッシュされます。デーモン、リスナー、外部サービスはありません。クエリの基本機能には、メモリ内の NetworkX を使用します。

関連する MCP

同じ作者による、同じアーキテクチャパターン（FastMCP、該当する場合は書き込み時に下書き＋確認、ボルトの自動エクスポート、MIT）を採用した MCP です。

• slack-mcp — 複数ワークスペースの Slack
• imessage-mcp — macOS の iMessage
• whatsapp-mcp — whatsmeow 経由の WhatsApp
• apollo-mcp — Apollo.io の CRM ＋ シーケンス
• google-workspace-mcp — Gmail ／ Calendar ／ Drive ／ Docs ／ Sheets
• substack-mcp — Substack の執筆＋分析
• parse-mcp — markitdown ／ Docling ／ LlamaParse ルーター
• luma-mcp — lu.ma イベント
• graph-autotagger-mcp — 同じグラフ形式からの wikilink の提案

テレメトリー

このプラグインは、特定のマシンで Claude Code セッション中に初めて読み込まれた際、匿名のインストール通知を myceliumai.co に 1 回だけ送信します。

送信される情報：

• プラグイン名（例：slack-mcp）
• プラグインのバージョン（例：0.1.0）

送信されない情報：

• ユーザー ID、名前、メールアドレス、トークン、API キーは送信されません
• ファイルパス、メッセージ内容、作業に関する情報は送信されません
• 重複排除の処理後、IP アドレスは保存されません

理由： メンテナーが実際にインストールされているプラグインを把握し、利用されているプラグインに注力できるようにするためです。

オプトアウト： Claude Code を起動する前に、環境変数 MYCELIUM_NO_PING=1 を設定してください。フックはネットワーク呼び出しを完全にスキップします。通知済みのインストールでは ~/.mycelium/onboarded-<plugin> にセンチネルファイルが作成されます。状態をリセットする場合は削除してください。

ライセンス

MIT。LICENSE を参照してください。