FastMCP server for Obsidian wikilink suggestions from a pre-computed knowledge g について
事前計算したgraphifyのナレッジグラフを使い、Obsidianノートのリンク候補を提案するFastMCPサーバーです。関連する高次数ノードやコミュニティを調べ、候補への判断をローカルに記録できます。
主な機能
- 01グラフのラベルからwikilinkを提案
- 02関連する高次数ノードの特定
- 03ノートとグラフコミュニティの照合
- 04SQLiteへの判断記録
活用シーン
- 01Obsidianノート執筆時の関連リンク検索
- 02ノートに関連する中心ノードの把握
- 03リンク候補の採用・却下の記録
MCP 対応
グラフに基づくリンク候補、コミュニティ照合、判断記録をMCPクライアント向けのツールとして公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
graph-autotagger-mcp
事前に計算された Obsidian ナレッジグラフを読み込み、ノートに追加するウィキリンクを提案する FastMCP サーバーです。graphify の併用を想定しています。graphify を実行してグラフを作成すると、この MCP が執筆中に関連性を提示します。
ツール
| ツール | 機能 |
|---|---|
suggest_links | グラフノードのラベルとのトークンの重なりに基づいて、ノートへのウィキリンクを提案します |
check_god_nodes | ノートに関連する高接続ノード(次数の上位 20 件)を確認します |
community_match | ノートが最も近いグラフコミュニティを特定します |
log_suggestion_decision | 採用/却下/無視の判断をローカルの SQLite データベースに記録します |
インストール
Claude Code を開き、次を貼り付けます。
/plugin marketplace add adelaidasofia/graph-autotagger-mcp
/plugin install graph-autotagger-mcp@graph-autotagger-mcp
インストール後、GRAPH_JSON_PATH を設定し(下記の環境変数を参照)、Claude Code を再起動してから、次のように尋ねます。
"このノートに追加するウィキリンクを提案してください:[ノートの内容を貼り付け]"
旧バージョンのインストール方法
pip install fastmcp
-
クローンします。
git clone https://github.com/adelaidasofia/graph-autotagger-mcp.git cd graph-autotagger-mcp -
graph.json へのパスを設定します。
export GRAPH_JSON_PATH="~/vault/.graph/graph.json"または、登録時に渡します(下記を参照)。
-
セルフテストを実行します。
python3 server.py -
Claude Code に登録します。
claude mcp add graph-autotagger -s user -- \ env GRAPH_JSON_PATH="$HOME/vault/.graph/graph.json" \ python3 /path/to/graph-autotagger-mcp/server.py -
Claude Code を再起動してから、次のように尋ねます。
"このノートに追加するウィキリンクを提案してください:[ノートの内容を貼り付け]"
環境変数
| 変数 | デフォルト | 説明 |
|---|---|---|
GRAPH_JSON_PATH | ~/vault/.graph/graph.json | graphify の出力へのパス |
AUTOTAGGER_DB | ~/.config/graph-autotagger/log.db | 提案の判断を記録する SQLite ログ |
仕組み
サーバーは起動時に graph.json を一度読み込み、メモリにキャッシュします。ノードラベルをトークン化し、トークンの重なりをスコア化してノートの内容と照合します。God Nodes(次数の上位 20 件)は、接続すると価値の高いクロスリンクを作成できるため、特別に扱われます。
log_suggestion_decision ツールを使うと、時間をかけてフィードバックデータセットを構築できます。採用された提案は関連性のしきい値の調整に利用でき、却下された提案からはグラフのノイズを特定できます。
graph.json の形式
graphify の出力形式(networkx の node_link_data)を想定しています。
{
"nodes": [{"id": "node-id", "label": "Node Label", "community": 0}],
"links": [{"source": "node-a", "target": "node-b"}]
}
注:networkx はエッジを "edges" ではなく "links" の下にシリアライズします。
関連する MCP
同じ作者による、同じアーキテクチャパターン(FastMCP、該当する場合は書き込み時にドラフトを作成して確認、Vault の自動エクスポート、MIT)を採用したプロジェクトです。
- slack-mcp - 複数の Slack ワークスペース
- imessage-mcp - macOS の iMessage
- whatsapp-mcp - whatsmeow 経由の WhatsApp
- google-workspace-mcp - Gmail/Calendar/Drive/Docs/Sheets
- apollo-mcp - Apollo.io の CRM とシーケンス
- substack-mcp - Substack の執筆と分析
- luma-mcp - lu.ma のイベント
- parse-mcp - markitdown/Docling/LlamaParse のルーター
- rescuetime-mcp - RescueTime の生産性データ
- graph-query-mcp - Vault のナレッジグラフクエリ
- investor-relations-mcp - シード調達パイプラインのトラッカー
- vault-sync-mcp - Vault の双方向同期
テレメトリ
このプラグインは、あるマシン上で Claude Code セッション内に初めて読み込まれたときに、匿名のインストールシグナルを 1 回だけ myceliumai.co に送信します。
送信される情報:
- プラグイン名(例:
slack-mcp) - プラグインのバージョン(例:
0.1.0)
送信されない情報:
- ユーザー識別情報、氏名、メールアドレス、トークン、API キーは送信されません
- ファイルパス、メッセージ内容、作業に関する情報は一切送信されません
- 重複排除処理後、IP アドレスは保存されません
目的: メンテナーが、実際にどのプラグインがインストールされているかを把握し、利用されているプラグインに注力できるようにします。
オプトアウト: Claude Code を起動する前に、環境変数 MYCELIUM_NO_PING=1 を設定してください。フックはネットワーク呼び出しを完全にスキップします。すでにシグナルを送信したインストールでは ~/.mycelium/onboarded-<plugin> にセンチネルファイルが作成されています。状態をリセットする場合は削除してください。
ライセンス
MIT
Mycelium AI が開発しました。完全版のインストールまたはチーム版は diazroa.com をご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。