enquire-mcp

配布状況： このブランチには、未公開のソース候補について記載されています。以下の候補版固有の npm コマンドと MCPB ダウンロード URL は、現在利用できません。利用可能な成果物については、公開済みの GitHub リリースまたは公開済みの npm バージョンをご利用ください。安定版のインストールコマンドは、候補版の手順とは別です。

claude mcp add obsidian -- npx -y @oomkapwn/enquire-mcp serve --vault ~/Documents/Obsidian\ Vault

AI は優秀です。しかし、その記憶は分断されています。

新しいチャットを始めるたびに、プロジェクトの履歴、決定事項、調査内容、そして苦労して得たコンテキストが失われます。ベンダーの記憶機能は 1 つの製品内では役立ちますが、別のエージェントに移ると消えてしまいます。従来のファイルコネクターはパスがすでに分かっているノートを開けます。ベクトル検索は類似した段落を見つけられます。しかし、どちらも完全な記憶システムではありません。

enquire-mcp により、Obsidian がエージェントのメモリデータベースになります

1 回インストールするだけで、既存の Vault が、あらゆる MCP 対応エージェント向けの永続的で検索可能なナレッジデータベースになります。ローカルでインデックスを作成し、さまざまな形式を横断して検索し、語彙・意味・グラフの各エビデンスに基づいて順位付けし、エージェントが引用できるソースコンテキストを返します。元のファイルは enquire-mcp がなくても読み取り、編集できます。

自分で管理するメモリ。 多くの会話メモリ製品は、チャットから事実を抽出し、別のストアに保存します。enquire-mcp は、Markdown、frontmatter、wikilinks、PDF、Canvas、Bases など、意図的に保持してきたナレッジを起点とします。検索結果は隠れた言い換えではなく、ソース資料に基づいています。

データを移行せずに、ドキュメントインテリジェンスを実現。 PDF は Markdown と同じローカルハイブリッド検索経路に入り、ページの引用情報とともに返されます。OCR によってスキャンされたページを読み取ることもできます。Canvas は型付きグラフになります。専用ツールは、これらの形式を不透明な添付ファイルとして扱うのではなく、サポート対象の Dataview LIST/TABLE サブセットと、サポート対象の Obsidian Base フィルターを実行します。

いつまでも変わらない記憶ではなく、鮮度を重視。 検索結果には age_days と stale を含めることができます。任意の最新性重み付けにより、エージェントは新しいナレッジを優先し、古い事実を自信満々に繰り返すのではなく再確認できます。

enquire-mcp の特長：

1. 鮮度を考慮した、引用付きの検索。 検索結果にはソースパスが保持され、経過日数と古さが示されます。PDF の検索結果にはページの引用情報が保持されます。任意の最新性再ランキングにより、エージェントは新しいナレッジを優先し、古い事実を再確認できます。
2. デフォルトで読み取り専用。 7 つの書き込みツールは --enable-write を指定するまで非表示です。プライバシーフィルターと厳密な Origin ベースの HTTP 許可により、公開範囲を抑えます。
3. Obsidian ネイティブのドキュメントインテリジェンス。 Markdown/PDF のハイブリッド検索に、型付き Canvas 解析、Dataview 形式の LIST/TABLE クエリー、サポート対象の Base フィルター実行を組み合わせています。
4. ローカル検索のフルスタック。 ハイブリッド BM25 + TF-IDF + 多言語埋め込みを RRF で融合し、任意の BGE クロスエンコーダー再ランキングとシグナルごとのスコアに対応しています。HNSW + int8 量子化により、密ベクトル検索をスケールできます。
5. 明確なデータ境界。 enquire はサーバー実行中に外部への呼び出しを一切行わず、テレメトリーも送信しません。接続先の MCP クライアントに、要求されたコンテキストのみを返します。その後のクラウド処理には、クライアント独自のプライバシー条件が適用されます。詳細はプライバシーポリシーをご覧ください。
6. ベンダーに依存しないメモリ。 ソースナレッジは、移植可能なファイルとして保持されます。独自仕様のメモリサイロを再構築することなく、エージェントやモデルプロバイダーを切り替えられます。

47 個のツール · 19 個の MCP プロンプト · 宣言済みテスト登録 2367 件 · 50 以上の言語 · v3.11.x 安定版 + v4 SDK-v2 プレビュー · semver 準拠 · MIT · npm ビルド来歴（SLSA L2）。

🏆 enquire-mcp が Obsidian の完全なインテリジェンススタックである理由

多くの代替製品は、アプリ内の類似性パネル、高性能な検索エンジン、または MCP によるファイルアクセスのいずれか一層を解決します。enquire-mcp は、ローカル検索の全段階、エージェントのオーケストレーション、リッチドキュメントへの対応、鮮度、安全性、リリース管理を 1 つのパッケージに統合しています。

_{✅ = 行全体の機能が組み込まれています。✕ = 調査対象の公開製品情報では、行全体の組み合わせが確認できませんでした。プロジェクトが行の一部を実装している場合や、後から追加する場合があります。調査日：2026-07-30。正確なソーススナップショットと各行の適用範囲については、競合製品のエビデンスをご覧ください。}

これが TOP-1 の主張です： 唯一の信頼できる情報源、1 つのローカルインテリジェンスレイヤー、すべてのエージェントを実現し、ナレッジをクラウド上のメモリの塊に変えてしまうことはありません。

enquire-mcp は、すでに所有している Obsidian ボルト上で動作する、Karpathy スタイルの LLM Wiki向けのオープンソースバックエンドです。知識を蓄積し、すべての回答をソースまで追跡できます。

⚡ クイックスタート

npm install -g @oomkapwn/enquire-mcp
enquire-mcp serve --vault ~/Documents/Obsidian\ Vault

任意の MCP クライアントに追加します：

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@oomkapwn/enquire-mcp", "serve", "--vault", "/path/to/vault"]
    }
  }
}

レビューしやすいデスクトップバンドルをお探しですか？ MCPB Basic をお使いください

v4.0.0-rc.7 GitHub Release では、enquire-mcp-basic-4.0.0-rc.7.mcpb とチェックサム、インベントリ、SBOM、通知、来歴情報を提供しています。このバンドルにはサーバーの JavaScript と通常の JavaScript 依存関係が含まれています。互換性のある MCPB ホストには、Node.js 22.13 以降が必要です。そのホストで開いてマニフェストを確認し、ホストに公開を許可する保管庫ディレクトリを 1 つ選択してください。

Basic は意図的に小規模です。 読み取り専用ツールはちょうど 13 個、プロンプトは0 個で、書き込みツール、ウォッチャー制御、永続的な／ディスク上のインデックス、埋め込みモデル、PDF、OCR の機能はありません。推奨される包括検索では、ライブ Markdown に対するインメモリ TF-IDF を遅延実行します。また、固定された起動契約により、フルエディションが既に使用している埋め込みデータベースやウォッチャーガードの検出も拒否されます。enquire はサービス提供中に外部への呼び出しを開始しません。ただし、要求されたノートの内容は、接続先の MCP クライアントに渡され、そのクライアントのプライバシー規約に従います。

リリースワークフローでは、公開前にバンドルの .sha256、ビルド／リリースの来歴情報、決定論的な論理コンテンツインベントリ、CycloneDX SBOM、サードパーティのライセンス／通知インベントリが必要です。固定された上流パッカーがパック時のメタデータを記録するため、アーカイブのバイトストリームが再現可能であるとは主張していません。バイト単位の一致が重要な場合は、公開済みのチェックサムを検証してください。実際のデスクトップ GUI へのインストール、署名、ディレクトリ承認の動作、ディレクトリ一覧表示は、引き続きメンテナーによる受け入れ作業の対象です。完全なハイブリッド検索は、以下の npm／CLI セットアップから引き続き利用できます。

📂 examples/ に設定テンプレートとエージェントのライフサイクルレシピがあります — Claude Desktop、Cursor、ChatGPT カスタム GPT（HTTP 経由のリモート MCP）に加え、クライアントを問わず使える想起、根拠、鮮度、統合、安全な書き込みのプレイブックも用意しています。

設定を手作業で組み立てたくありませんか？ CLI に ご利用の保管庫とクライアントに合った正確なスニペットを表示させましょう（非破壊的で、何も書き込みません）。v3.11.6 以降：

enquire-mcp configure --vault <path>                 # prints config for every client
enquire-mcp configure --vault <path> --client cursor # just one (claude-code|cursor|vscode|codex|windsurf|claude-desktop|http)

出力では、各クライアントのインストール境界を正確に示します。VS Code には公式の確認・インストール URI が表示され、Claude Code と Codex にはコピーして実行できるコマンドが表示されます。また、ワンクリックの手順で Marketplace／Registry のエントリーしか受け付けないクライアントは、正確な代替設定とともにコピーのみと表示されます。生成された保管庫のパスと物理パッケージのエントリーポイントは、保存する前に確認できる状態で表示されます。

ハイブリッド機能をすべて使いたいですか？ ハイブリッドの事前チェックを完了してから、サービスを開始してください。

npm install -g @oomkapwn/[email protected]      # exact prerelease package
enquire-mcp --version
# recommended: preview first, then explicitly apply the same package-coherent plan
enquire-mcp first-run --tier hybrid --client claude-desktop --vault <path>
enquire-mcp first-run --tier hybrid --client claude-desktop --vault <path> --apply
# manual equivalent below: choose this instead of first-run --apply, not in addition
enquire-mcp setup --vault <path>                          # caches embedder; builds FTS5 + embed-db
enquire-mcp install-model rerank-bge                      # caches the offline reranker
enquire-mcp doctor --tier hybrid --vault <path>           # structural/runtime readiness
enquire-mcp configure --tier hybrid --client claude-desktop --vault <path>
enquire-mcp serve --vault <path> --persistent-index --enable-reranker --use-hnsw

🤖 AI エージェントに設定 — プロンプトをコピーして貼り付け

すべての接続で、設定に応じた initialize.instructions が受け取られるようになりました。ここには推奨される想起ワークフロー、引用と鮮度の意味、現在の書き込み方針、取得した保管庫の内容は指示ではなくデータであるというルールが含まれます。MCP サーバーの指示を表示するクライアントでは、この契約を自動的に利用できます。以下のコピー＆ペースト用プロンプトは、ユーザー設定を明示したい場合や、サーバーの指示を公開しないホストで引き続き役立ちます。

# Add the MCP server to your Claude Code config (one time)
claude mcp add obsidian -- npx -y @oomkapwn/enquire-mcp serve --vault ~/Documents/Obsidian\ Vault

enquire-mcp configure --client vscode --vault <path>

enquire-mcp configure --client codex --vault <path>

再利用可能なエージェントルール（エージェントが保管庫をいつ参照するか分かるように、任意の AGENTS.md / CLAUDE.md / .cursorrules に追加してください）：

質問が自分のメモ、決定事項、プロジェクト、人物、調査に関係する場合は、obsidian_* ツール（obsidian_search から始める）でまず Obsidian 保管庫を検索し、すべての事実について出典のノートを引用してください。概念的な内容、言語をまたぐ内容、「X について何と言ったか」といった検索には enquire を優先し、完全一致する文字列の検索には通常の grep / ripgrep を使用してください。関連する結果が見つからない場合は、その旨を伝え、推測しないでください。

効果的なクエリの例

• 「価格戦略について議論したノートをすべて見つけて、変遷を要約してください。」 — RRF 融合 + リランカーが「変遷」を意味的に処理します
• 「PostgreSQL と MongoDB について、どのような決定をしましたか？日次ノートを引用してください。」 — 融合した候補の RRF スコアが同じ場合、候補セット内のウィキリンクの入次数で順位を決めます
• 「Проведи анализ моих заметок о RAG за последние 3 месяца」 — 多言語埋め込み + frontmatter の日付フィルター
• 「LLaMA-3 の論文 PDF のどのページでスケーリングについて説明していますか？」 — PDF を [page: N] の引用付きで検索に統合します
• 「研究用保管庫にあるトピック別コミュニティを見せてください。どんなテーマを調べてきましたか？」 — obsidian_get_communities（GraphRAG-light）

🧠 ユースケース

1 — AI エージェントの長期記憶。 Obsidian の保管庫を、MCP 互換のエージェント（Claude Code、Claude Desktop、Cursor、ChatGPT、Codex、OpenClaw）に接続するだけで使えます。エージェントは、これまでに書いたすべての会議メモ、日記、調査ログ、意思決定ドキュメントを、セッション、モデル、プロバイダーをまたいで永続的かつ意味的に検索できるようになります。ナレッジは特定ベンダーのメモリーレイヤーに閉じ込められず、自分で所有し、自由に移行できるプレーンな Markdown として保管されます。

2 — 個人ナレッジベース／第二の脳。 ハイブリッド検索により、50 以上の言語で、どのような言い回しでも適切なノートを見つけられます。2 年前のロシア語の日記について英語で尋ねても、適切な結果が返されます。Wiki リンクによるグラフブーストは、候補セット内の入次数を使って、RRF スコアが同じ結果の順位だけを決めます。GraphRAG-light はトピックごとのコミュニティを提示し、忘れていたつながりを見つけられるようにします。PDF は [page: N] の引用付きで検索に統合されるため、研究論文や会議の文字起こしも第一級の記憶になります。

3 — エージェント型 RAG／コンテキストエンジニアリング。 obsidian_search はシグナルごとのスコアを公開するため、エージェントは各結果がなぜ上位にランクされたのかを確認できます。HyDE は検索前に曖昧なクエリを書き換え、内容豊かな仮想回答にします。サブ質問への分解では、「価格戦略はどのように変化し、顧客の反応はどうだったか？」のような複数段階の質問を独立したサブクエリに分け、結果を統合します。組み込みの評価ハーネス（NDCG／Recall／MRR）を使えば、ベンダーのベンチマークを鵜呑みにせず、自分のクエリで検索品質を測定できます。

✅ 本格的なローカルナレッジワークフローのために構築

以下を求めるなら、enquire-mcp をお選びください。

• 別のプロプライエタリなストアにナレッジをコピーせず、Obsidian の保管庫を信頼できる唯一の情報源として維持すること。
• 複数の AI エージェントで共有できる単一のメモリーレイヤーにより、モデルを切り替えても最初からやり直さずに済むこと。
• 表現の違いに左右されず、完全一致だけに頼らない概念的・多言語的な検索。
• ノートのパス、PDF のページ、シグナルスコア、鮮度メタデータを含む、出典を示して検証できる回答。
• 読み取り専用をデフォルトとし、書き込みには明示的なゲートを設け、serve 中に enquire が開始する外部への呼び出しをゼロにし、MCP クライアントとの信頼境界を文書化した、ローカル優先のプライバシー。
• ハイブリッド検索、再ランキング、グラフコンテキスト、エージェント型の拡張、Obsidian の豊富な形式、リモート MCP に対応する、完全な検索バックエンド。

対応範囲を明確にすると： enquire-mcp は、Markdown、Canvas、Bases、PDF のナレッジを扱うヘッドレス MCP サーバー／CLI です。リテラルトークンの検索には、完全一致検索ツールを併用してください。エージェントからリモートアクセスする必要がある場合は、組み込みの HTTP トランスポートを使用してください。

📖 製品サイトと API リファレンス

**製品の入口では、出典付きメモリーによって得られる成果、その根拠、クライアントの利用方法、AI が読み取れるリソースについて説明しています。完全自動生成のAPI リファレンス**には、すべてのツール、プロンプト、エクスポートされたヘルパーが、完全な TSDoc（@param／@returns／@example）とともに記載されています。どちらも、publish-docs.yml により、main へのプッシュごとにソースから再構築されます。過去の詳細な TypeDoc URL も引き続き有効です。

🏗️ 検索の仕組み

graph LR
    Q[Query] --> S[obsidian_search]
    S --> BM25[BM25 / FTS5]
    S --> TFIDF[TF-IDF cosine]
    S --> EMB[ML embeddings<br/>HNSW]
    BM25 --> RRF{RRF fusion<br/>k=60}
    TFIDF --> RRF
    EMB --> RRF
    RRF --> GB[Graph boost<br/>in-degree tie-break]
    GB --> RR[BGE cross-encoder<br/>reranker]
    RR --> R[Ranked hits<br/>per_signal observability]

obsidian_search は利用可能なシグナルを自動検出し、利用できない場合は適切に機能を縮退します。Wikilink グラフブーストでは、候補セット内の入次数のみを使って、RRF スコアが同点の結果の順位を決めます。オプションのクロスエンコーダーによる再ランキングでは、上位 N 件を再スコアリングし、実測で NDCG@10 が +15.5 向上します。各検索結果には per_signal: { bm25, tfidf, embeddings } が含まれるため、なぜその順位になったのかを確認できます。

🛠️ 47 個のツールすべて

本番環境向けのツールは合計 47 個です。常時利用可能な読み取りツールが 35 個（包括的な検索ツール obsidian_search を含む）、オプトインの読み取りツールが 4 個、条件付きで有効になる書き込みツールが 7 個、クローズドループのフィードバックツールが 1 個です。全リファレンスは docs/api.md をご覧ください。

さらに、MCP リソースが 3 個（obsidian://vault/info、obsidian://note/{path}、obsidian://chunk/{n}/{path}）と、一般的な Vault のワークフロー向けの MCP プロンプトが 19 個（summarize_recent_edits · review_tag · find_orphans · weekly_review · extract_todos · process_inbox · consolidate_tags · find_duplicates · lint_wiki · monthly_review · search_with_query_expansion · vault_synth · vault_wiki_compile · vault_lint_extended · vault_capture · vault_persona_search · vault_automation_setup · vault_research · vault_synthesis_page）あります。

🛡️ 信頼性

❓ よくある質問

Obsidian のインストールは必要ですか？ いいえ。.md、.canvas、.pdf を直接読み取ります。Obsidian 形式のあらゆる Vault で動作します。

Vault に書き込みますか？ --enable-write を指定しない限り、書き込みません。7 つの書き込みツールはすべてゲートで制御され、破壊的な操作には dry_run が用意されています。

データはどこかに送信されますか？ enquire はテレメトリーを送信せず、serve 中に外部への HTTP 接続も開始しません。ただし、接続した MCP クライアントには、要求された Vault のコンテキストを返します。クラウドクライアントは独自のプライバシーポリシーに基づいてそのコンテキストを処理する場合があり、トンネルやプロキシも新たな信頼境界となります。明示的な取得コマンドである setup、build-embeddings、install-model は Hugging Face から ONNX の重みを取得する場合があります。ハイブリッド層の first-run --apply は同じ取得処理を実行し、install-ocr-lang は Tesseract の言語パックを取得します。詳細なポリシー：SECURITY.md。

パフォーマンスはどうですか？ Vault のサイズ、ハードウェア、モデル、有効にした検索レイヤーによって異なります。公開されている実績には、1,771 チャンク／368 ファイルで BM25 の top-10 が 50～100ms という本番環境のレポートと、100～1,000 件のノートで線形スキャンに対して FTS5 が 37～103 倍高速になることを示す再現可能な合成ベンチマークがあります。レイテンシの SLO を設定する前に、組み込みの評価コマンドとベンチマークコマンドを自分の Vault で実行してください。ベンチマークとFTS5 実装ノートを参照してください。

対応言語は？ デフォルトの埋め込みモデルは paraphrase-multilingual-MiniLM-L12-v2（50 言語以上）で、ロシア語と英語のバイリンガル Vault でエンドツーエンドの検証を済ませています。デフォルトのクロスエンコーダー再ランキングモデルは rerank-bge（英語のみ。カタログのエイリアスのうち、エンドツーエンドで検証済みなのはこれだけ）です。多言語再ランキングモデルのエイリアスは現在、transformers.js のトークナイザー互換性チェックに失敗します。CJK／タイ語／クメール語のトークナイズには Intl.Segmenter を使用します。

リモートで実行できますか？ はい。serve-http を使うと、Streamable HTTP 経由で同じサーバーを公開できます。v4 プレビューでは、厳密なモダン 2026-07-28 トラフィックと、サポート対象のレガシークライアントに対して、1 つの登録済みサーフェスを基盤とする公式 SDK v2 の別々の経路を使用します。不正な形式またはサポート対象外のモダンな要求は、レガシー経路にフォールバックしません。HTTPS を利用するには、Tailscale Funnel または Cloudflare Tunnel を前段に配置してください。claude.ai web、ChatGPT カスタム GPT、Cursor HTTP mode、モバイル MCP クライアントで動作します。docs/http-transport.md を参照してください。

🚀 リリース

v3.0.0 — 安定版チャンネル。 v2.x の検索ロードマップが完了し、公開サーフェスは現在セマンティックバージョニングの対象です。主なリリース：

v2.0 ハイブリッド検索（BM25＋TF-IDF＋埋め込み、RRF 経由） · v2.6 リモート MCP · v2.7-2.8 PDF の統合 · v2.9 BGE 再ランキングモデル · v2.10 OCR · v2.11 doctor ＋ setup · v2.12 評価ハーネス · v2.13 HNSW · v2.14 ステートフルセッション · v2.15 レイトチャンク化 · v2.16 HNSW の永続化 · v2.17 int8 量子化 · v3.8.0 安定版 · v3.8.7 HTTP トランスポートの強化 · v3.9.0 安定版：OCR 処理済み PDF のウォッチャーによる埋め込み同期、ファイル変更時の HNSW メモリー内ライブ更新、R-10 アダプティブ HNSW 補充（除外率が 66% を超えた際の結果不足を解消）。 · v3.10 安定版：忘却を考慮した鮮度管理 — age_days ＋ stale フラグ ＋ オプトインの --recency-weight による再ランキング ＋ フロントマターを考慮した obsidian_search。

チャンネル：npm install @oomkapwn/enquire-mcp → 最新の安定版（@latest = v3.11.x）。プレリリース：npm install @oomkapwn/enquire-mcp@rc → v4 SDK-v2 候補版。プレビュー版を正確に指定してインストールするには @4.0.0-rc.7 を指定してください。完全な変更履歴：CHANGELOG.md · 今後の計画：ROADMAP.md。

🤝 コントリビューション

git clone https://github.com/oomkapwn/enquire-mcp.git
cd enquire-mcp && npm install
npm test       # full suite (2367 declared test registrations)
npm run lint   # zero warnings
npm run build  # tsc → dist/

Issue、PR、アイデアを歓迎します。セットアップに関する質問、バグ報告、非公開のセキュリティ報告先については、SUPPORT.md を参照してください。

📜 ライセンス

MIT。 Alex (@OomkaBear) が開発しました。 Tim Berners-Lee が 1980 年に開発した WWW のプロトタイプ にちなんで名付けられました。これは、ウェブが登場する前のオリジナルのハイパーテキストシステムです。元の仕様では、システムに何でも質問できました。 enquire-mcp がその機能をあなたの Vault にもたらします。