vault-knowledge

vault-knowledge-mcp

Obsidian ボルトの型付きナレッジグラフを、あらゆる MCP クライアントから呼び出せる 3 つのツールに変換する読み取り専用の MCP サーバーです。多くのナレッジツールは検索できます。しかし、自分のノート同士がどこで食い違っているかを教えてくれるものはほとんどありません。このサーバーは 6 種類の関係からなる推論グラフをたどり、最も鋭いエッジである contradicts を提示します。ローカルファースト、stdio、認証不要、クラウド不使用、ネイティブビルド不要です。

推論の詳細は docs/EXPLANATION.md をご覧ください。

ツール

ツール	戻り値
search_concepts(query, limit=5)	意味的に順位付けされた概念／関連性の記事です。
find_contradictions(scope='all'|'recent_30d')	推論グラフ内の有効な contradicts エッジです。
get_article(slug)	フロントマター、本文、解決済みのウィキリンクを含む 1 件の記事です。

お試しください — 設定不要

合成エスプレッソボルトが付属しているため、インストール直後から動作します。

{
  "mcpServers": {
    "vault-knowledge": { "command": "npx", "args": ["-y", "@swins/vault-knowledge-mcp"] }
  }
}

次に、「ボルト内の矛盾を見つけてください」と尋ねてください。

自分のボルトを指定する

{
  "mcpServers": {
    "vault-knowledge": {
      "command": "npx",
      "args": ["-y", "@swins/vault-knowledge-mcp"],
      "env": {
        "VAULT_DB": "/abs/path/.vault-index.db",
        "VAULT_ROOT": "/abs/path/vault"
      }
    }
  }
}

読み取り可能なのは knowledge/{concepts,connections,qa} だけです。スコープは設定のみで指定し、リクエストパラメーターとして指定することはできないため、クライアントが対象範囲を広げることはできません。

要件

Node ≥ 22.5（組み込みの node:sqlite）。search_concepts は初回実行時に nomic-embed-text-v1.5 モデルを一度ダウンロードします。

ライセンス

MIT。