Kobsidian

🧰 ワークスペースを備えた唯一の Obsidian MCP です。 vault.list / vault.select により、LLM はセッション中に Obsidian ボルトを検出して切り替えられます — 再起動も、設定ファイルの編集も、ツールごとにパスを渡す必要もありません。OBSIDIAN_VAULT_PATH との 下位互換性があります。v0.3.0 で追加されました。 docs/WORKSPACES.md をご覧ください。

v0.3.7 の新機能

.kobsidian.json を使って各ボルトを個別に設定できます。wiki フォルダー、ファイル名、見出し、古いページとみなすしきい値をカスタマイズでき、すべてのボルトで設定を共有する必要はありません。notes.edit の見出し挿入では、段落間のスペースも維持され、既存のリストにも自然につながります。

設定例とアップグレード時の注意事項。

kObsidian を選ぶ理由

• ファイルシステムを最優先。 Vault を直接操作します。66 個のツールのうち 55 個以上は、Obsidian を起動していなくても使用できます。
• 型付きの MCP ツールを 66 個搭載。 Vault、ノート、リンク、タグ、タスク、Dataview、Canvas、Kanban、フェンス付きブロック、Marp、Templates に対応し、すべてのツールで Zod による検証と structuredContent 出力を行います。また、MCP アノテーションの 4 つのヒント（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）をすべて備えています。
• 複数の Vault に対応した vault.*（v0.3.0）。 LLM は vault.list を使って、既知の Obsidian Vault（Obsidian 独自のレジストリまたは OBSIDIAN_VAULT_<NAME> 環境変数から検出）を一覧表示し、セッション中に vault.select で切り替えられます。完全な後方互換性があり、OBSIDIAN_VAULT_PATH が引き続きデフォルトとして使われ、呼び出しごとの vaultPath 引数が常に優先されます。
• LLM-Wiki オーケストレーション。 wiki.* 名前空間を使って、Vault を知識が蓄積されるナレッジベースに変えます。ソースを取り込み、インデックスと grep 可能なログを自動更新し、孤立したページ、リンク切れ、古くなったページを検査します。エージェントは proposedEdits コントラクトを介して相互参照を適用するため、すべての書き込みがトランスクリプトで確認できます。
• 両方のトランスポートに対応。 ローカルの MCP クライアント向けの従来型 stdio と、リモート向けの Streamable HTTP（Hono）に対応し、CORS プリフライト、MCP-Protocol-Version の処理、オリジンへの 403 応答、オプションのベアラー認証を備えています。すべて 2025-11-25 仕様に準拠しています。
• Claude Code のスキーマ互換性（v0.3.5 以降、v0.3.6 で改良）。 ツールは stdio とステートレスな Streamable HTTP の両方で JSON Schema 2020-12 を公開します。Union 形式のツールはフィールドとセレクターをクライアントに公開し、Zod は引き続き各呼び出しと構造化出力を検証します。詳しくは互換性の詳細をご覧ください。
• あらゆる場所で利用可能。 npm（npx -y kobsidian-mcp）、Claude Desktop にドラッグ＆ドロップできるクロスプラットフォーム対応の .mcpb バンドル、Smithery 用の smithery.yaml、MCP Registry 用の server.json を提供します。各 .mcpb リリースアセットは VirusTotal でスキャンされ、リンクがリリース本文に追加されます。

インストール

以下からクライアントを選んでください。すべてのクライアントが完全なハイブリッドモードに対応しています — ファイルシステム優先のツール（80 個以上）はボルトのパスだけで動作し、同じ設定に Local REST API キーを同時に指定すると、workspace.*、commands.*、および dataview.query* によるライブ DQL が利用可能になります。環境変数のブロック全体をクライアントごとに一度設定すれば、すべてのツール名前空間が使えるようになります。REST キーを空欄にしても、ファイルシステム優先のツールは引き続き動作します。

全項目は docs/ENVIRONMENT.md をご覧ください。コールドスタートを約 200 ms から約 10 ms に短縮したい場合は、どこでも npx を bunx に置き換えてください。

claude mcp add kobsidian -s user \
  --env OBSIDIAN_VAULT_PATH=/absolute/path/to/vault \
  --env OBSIDIAN_API_URL=https://127.0.0.1:27124 \
  --env OBSIDIAN_REST_API_KEY=only-if-you-use-workspace-or-commands-tools \
  -- npx -y kobsidian-mcp

bun install
bun run build:compile   # → dist/kobsidian (or .exe on Windows)
bun run bundle:mcpb     # → kobsidian.mcpb

codex mcp add kobsidian \
  --env OBSIDIAN_VAULT_PATH=/absolute/path/to/vault \
  --env OBSIDIAN_API_URL=https://127.0.0.1:27124 \
  --env OBSIDIAN_REST_API_KEY=only-if-you-use-workspace-or-commands-tools \
  -- npx -y kobsidian-mcp

{
  "mcpServers": {
    "kobsidian": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "kobsidian-mcp"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/absolute/path/to/vault",
        "OBSIDIAN_API_URL": "https://127.0.0.1:27124",
        "OBSIDIAN_REST_API_KEY": "only-if-you-use-workspace-or-commands-tools"
      }
    }
  }
}

code --add-mcp '{"name":"kobsidian","command":"npx","args":["-y","kobsidian-mcp"],"env":{"OBSIDIAN_VAULT_PATH":"/absolute/path/to/vault","OBSIDIAN_API_URL":"https://127.0.0.1:27124","OBSIDIAN_REST_API_KEY":"only-if-you-use-workspace-or-commands-tools"}}'

gemini mcp add kobsidian \
  --env OBSIDIAN_VAULT_PATH=/absolute/path/to/vault \
  --env OBSIDIAN_API_URL=https://127.0.0.1:27124 \
  --env OBSIDIAN_REST_API_KEY=only-if-you-use-workspace-or-commands-tools \
  -- npx -y kobsidian-mcp

{
  "mcpServers": {
    "kobsidian": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "kobsidian-mcp"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/absolute/path/to/vault",
        "OBSIDIAN_API_URL": "https://127.0.0.1:27124",
        "OBSIDIAN_REST_API_KEY": "only-if-you-use-workspace-or-commands-tools"
      }
    }
  }
}

{
  "context_servers": {
    "kobsidian": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "kobsidian-mcp"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/absolute/path/to/vault",
        "OBSIDIAN_API_URL": "https://127.0.0.1:27124",
        "OBSIDIAN_REST_API_KEY": "only-if-you-use-workspace-or-commands-tools"
      }
    }
  }
}

{
  "mcp": {
    "kobsidian": {
      "type": "local",
      "command": ["npx", "-y", "kobsidian-mcp"],
      "environment": {
        "OBSIDIAN_VAULT_PATH": "/absolute/path/to/vault",
        "OBSIDIAN_API_URL": "https://127.0.0.1:27124",
        "OBSIDIAN_REST_API_KEY": "only-if-you-use-workspace-or-commands-tools"
      }
    }
  }
}

droid mcp add kobsidian "npx -y kobsidian-mcp" \
  --env OBSIDIAN_VAULT_PATH=/absolute/path/to/vault \
  --env OBSIDIAN_API_URL=https://127.0.0.1:27124 \
  --env OBSIDIAN_REST_API_KEY=only-if-you-use-workspace-or-commands-tools

{
  "mcpServers": {
    "kobsidian": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "kobsidian-mcp"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/absolute/path/to/vault",
        "OBSIDIAN_API_URL": "https://127.0.0.1:27124",
        "OBSIDIAN_REST_API_KEY": "only-if-you-use-workspace-or-commands-tools"
      }
    }
  }
}

Smithery

smithery.ai は smithery.yaml から直接インストール UI を生成し、4 つの環境変数を収集します — ボルトのパスに加えて、任意の Local REST API URL ／ TLS ／ベアラーキーの 3 項目です。これにより、ハイブリッドモードをすぐに利用できます。

ソースから（コントリビューション／開発）

git clone https://github.com/bezata/kObsidian
cd kObsidian
bun install
bun run dev:stdio    # or dev:http

Obsidian プラグイン

kObsidian はファイルシステム優先です。66 個のツールのうち 55 個以上は、Obsidian のプラグインがインストールされていない状態でも、Vault ディレクトリだけで動作します。以下のプラグインが必要なのは、それらに依存する特定のツール名前空間を使いたい場合のみです。

コミュニティプラグインを有効にする（まだ有効にしていない場合、初回のみ）

Obsidian では、コミュニティプラグインはデフォルトで無効になっています。Vault ごとに一度、有効にしてください。

1. Obsidian で Vault を開きます。
2. 設定（⚙️、左下）→ コミュニティプラグインを開きます。
3. コミュニティプラグインを有効にするをクリックします。
4. 閲覧 → 検索 → インストール → 有効化の順に操作します。

REST ブリッジ経由のツールに必須

Obsidian Local REST API（Adam Coddington 作）が必要なもの：

• workspace.*（activeFile、openFile、navigate、closeActiveFile、toggleEditMode）
• commands.*（execute、list）
• dataview.query / dataview.listByTag / dataview.listByFolder / dataview.table（実行時の DQL。オフラインの dataview.fields.* / dataview.index / blocks.* ツールは不要です）
• engine: "templater" を指定した templates.use

インストール後の設定：

1. プラグインを有効にします。
2. プラグインの設定を開き、API keyまでスクロールしてコピーをクリックします（新しいキーが必要な場合は、先にリセットをクリックしてください）。
3. キーを、MCP クライアント設定の env: ブロックにある OBSIDIAN_REST_API_KEY として貼り付けます。デフォルトの OBSIDIAN_API_URL（https://127.0.0.1:27124）はそのまま使えます。

REST ブリッジ経由のツールを使っている間は、プラグインを起動したままにしてください。エンドポイントはローカル専用（127.0.0.1）なので、データがマシンの外に送信されることはありません。

特定のツール名前空間を強化するプラグイン（必須ではありません）

obsidian://show-plugin?id=… リンクをクリックすると、Obsidian のアプリ内ブラウザーで該当するプラグインが直接開きます。Obsidian を開いた状態でリンクをクリックすると、インストール画面に直接移動します。

要約

どのプラグインの組み合わせでも、kObsidian が Obsidian の起動に依存することはありません。プラグインに接続できない場合、REST ブリッジ経由のツールは明確なエラーを返し、ファイルシステム優先のツールは引き続き動作します。

クイックスタート

初回セッションの前に — kObsidian は Obsidian の空の保管庫で動作しますが、 いくつかの Obsidian プラグインを有効にすると、利用できるツールがすべて使えるようになります。 5 分でできるセットアップ（Local REST API、Dataview、Templater、Marp、Kanban、Tasks）については、 以下のObsidian プラグインをご覧ください。 ファイルシステム中心の 80 以上のツールだけで十分な場合は、読み飛ばしてください。

インストール後、通常のセッションは自然言語のプロンプト 3 つから始まります。 残りは wiki.* ツールと .claude スキルが処理します。

You:  "Set up a wiki in this vault."
LLM:  wiki.init  →  wiki/{Sources,Concepts,Entities}/ + index.md + log.md + wiki-schema.md

You:  "Ingest this: https://… (paper on Memex)"
LLM:  wiki.ingest  →  creates wiki/Sources/as-we-may-think.md + log entry
      returns proposedEdits:
        - insertAfterHeading  index.md#Sources
        - createStub          Concepts/memex.md
        - createStub          Entities/vannevar-bush.md
      LLM applies each via notes.*  (you see every write in the transcript)

You:  "What does the wiki say about memex vs hypertext?"
LLM:  wiki.query memex  →  top-ranked pages
      notes.read on each  →  cited synthesis
      offers to file the synthesis back via wiki.summaryMerge

You:  "Audit the wiki."
LLM:  wiki.lint  →  {orphans, brokenLinks, stale, missingPages, tagSingletons, indexMismatch}
      proposes concrete fixes; applies after you confirm

一連の流れ、フロントマターの契約、proposedEdits の設計については、 docs/wiki.mdをご覧ください。

使用例

同じ基本要素で、実際のさまざまなナレッジベースに対応できます。 以下に 3 つの具体例を示します。詳しい手順はdocs/examples.mdをご覧ください。

A. 個人用リサーチ Wiki

You: "Ingest this paper on in-context learning: <url or pasted markdown>"
LLM:  wiki.ingest title="In-Context Learning — A Survey" sourceType=paper
        tags=[icl, prompting] relatedConcepts=[In-Context Learning, Few-Shot Prompting]
        relatedEntities=[Brown 2020]
      → wiki/Sources/in-context-learning-a-survey.md
      → proposedEdits:
          • createStub  wiki/Concepts/in-context-learning.md
          • createStub  wiki/Concepts/few-shot-prompting.md
          • createStub  wiki/Entities/brown-2020.md
          • insertAfterHeading  wiki/index.md#Sources
      LLM applies each via notes.create / notes.edit (mode: "after-heading").

B. コードベースのアーキテクチャ決定記録（ADR）

各 ADR を Source、アーキテクチャパターンを Concepts、サービス／チーム／ライブラリを Entities としてモデル化します。 Wiki は、手作業で保守する必要のない相互リンク付きの ADR アーカイブになります。

You: "Record ADR-004: we're switching internal service comms from REST
      to gRPC. Context: <paste>"
LLM:  wiki.ingest title="ADR-004 — gRPC for internal service comms"
        sourceType=note tags=[adr, architecture, rpc]
        relatedConcepts=[gRPC, Service Mesh, Internal RPC]
        relatedEntities=[order-service, payment-service, inventory-service]
      → wiki/Sources/adr-004-grpc-for-internal-service-comms.md
      → proposedEdits:
          • createStub   wiki/Concepts/grpc.md
          • createStub   wiki/Concepts/service-mesh.md
          • insertAfterHeading  wiki/Entities/order-service.md#Notable Facts
          • insertAfterHeading  wiki/Entities/payment-service.md#Notable Facts
          • …

Three weeks later —
You: "Why did we pick gRPC for internal comms?"
LLM:  wiki.query "grpc internal comms"
      notes.read top matches
      → "Per [[wiki/Sources/adr-004-grpc-for-internal-service-comms.md|ADR-004]],
         chosen over REST because of native streaming + typed schemas; tradeoff
         accepted: browser clients still use REST via an edge gateway
         ([[wiki/Concepts/service-mesh.md]])."

C. コードベース Wiki（設計ドキュメント＋事後分析＋RFC）

エンジニアリングチームが Wiki を使わなくなるのは、誰も更新しないからです。LLM に任せましょう。設計ドキュメント、RFC、事後分析を Sources として取り込み、アーキテクチャパターンを Concepts、サービスやチームを Entities にします。

You: "We had an incident today — payment-service timeouts cascaded
      into order-service. Here's the post-mortem: <paste>"
LLM:  wiki.ingest title="Postmortem 2026-04-10 — Payment timeouts cascade"
        sourceType=other tags=[postmortem, incident, reliability]
        relatedConcepts=[Circuit Breaker, Cascade Failure, Timeout Budget]
        relatedEntities=[payment-service, order-service]
      → wiki/Sources/postmortem-2026-04-10-payment-timeouts-cascade.md
      → proposedEdits:
          • createStub  wiki/Concepts/circuit-breaker.md
          • createStub  wiki/Concepts/cascade-failure.md
          • insertAfterHeading  wiki/Entities/payment-service.md#Notable Facts
          • insertAfterHeading  wiki/Entities/order-service.md#Notable Facts

Periodic housekeeping —
You: "Audit the codebase wiki."
LLM:  wiki.lint
      → 3 orphan RFCs (unlinked from any Concept; link or archive?)
      → 1 broken link: [[wiki/Entities/legacy-auth-service.md]]
        (deprecated in Q1; remove the link from
         [[wiki/Sources/adr-002-session-migration.md]]?)
      → 4 post-mortems past the 180-day stale threshold — tag with
        "needs-review" or re-ingest with updated lessons-learned?
      → 2 tag singletons: `retry-logic` (merge into `retry-policy`?),
        `observability` (first use; keep).

エンジニアリングチームで効果を発揮する理由

• proposedEdits の契約により、すべての相互参照の書き込みがトランスクリプトに表示されます。決定がどのサービスに影響するかについて LLM が幻覚しても、保管庫が気付かないうちに破損することはありません。
• 検索しやすいログ形式（## [YYYY-MM-DD] ingest | ADR-004 …）により、grep '^## \[' wiki/log.md | tail -20 を「チームが最近決定したこと」を調べるクエリとして使えます。
• wiki.lint は、何か月も前に廃止されたサービスへのリンク切れを検出します。人間がなかなか手を付けられない記録管理を任せられます。

アーキテクチャ

┌──────────────────────────────────────────────────────────────────────┐
│                           MCP Clients                                │
│   Claude Code · Claude Desktop · Cursor · VSCode · Antigravity · Zed │
│   JetBrains AI · Cline · Continue · ChatGPT · Smithery · …           │
└────────────────────────────┬─────────────────────────────────────────┘
                             │ JSON-RPC 2.0 · MCP 2025-11-25
         ┌───────────────────┴──────────────────────┐
         ▼                                          ▼
┌──────────────────┐                   ┌─────────────────────────┐
│ stdio transport  │                   │ Streamable HTTP (Hono)  │
│                  │                   │ + OPTIONS / CORS        │
│                  │                   │ + MCP-Protocol-Version  │
│                  │                   │ + Origin 403 / bearer   │
└────────┬─────────┘                   └────────┬────────────────┘
         │                                      │
         └──────────────────┬───────────────────┘
                            ▼
          ┌──────────────────────────────────┐
          │          McpServer               │
          │  ┌────────────┐ ┌─────────────┐  │
          │  │  90 Tools  │ │ 4 Resources │  │
          │  └────────────┘ └─────────────┘  │
          │  ┌────────────┐ ┌─────────────┐  │
          │  │ 3 Prompts  │ │ structured  │  │
          │  │            │ │   content   │  │
          │  └────────────┘ └─────────────┘  │
          └────────────┬─────────────────────┘
                       │
                       ▼
          ┌──────────────────────────────────┐
          │      Domain layer (pure)         │
          │  notes · links · tags · tasks    │
          │  dataview · canvas · kanban      │
          │  blocks · marp · templates       │
          │  wiki/ orchestration             │
          └──────┬─────────────────┬─────────┘
                 │                 │
                 ▼                 ▼
         ┌──────────────┐   ┌──────────────────────┐
         │  vault/ (FS) │   │ Obsidian Local REST  │
         │ authoritative│   │ API plugin (optional)│
         └──────────────┘   └──────────────────────┘

モジュールの全体図についてはdocs/architecture.mdをご覧ください。

LLM Wiki（60 秒）

ナレッジベースの維持管理で面倒なのは、読むことでも考えることでもなく、記録を整理することです。人間が Wiki を使わなくなるのは、保守の負担が価値を上回るためです。LLM は飽きません。

kObsidian はAndrej Karpathy の gistにあるLLM Wikiパターンを実装しています。これは LLM が維持する、継続的に蓄積されるナレッジベースです。保管庫は、Vannevar Bush が 1945 年に提唱した Memex のような、非公開でキュレーションされた知識基盤になります。相互参照、ログの記録、Lint は LLM に任せ、あなたはソースのキュレーションと質問に集中できます。

「クエリ時に生のドキュメントから情報を取得するだけでなく、LLM が永続的な Wiki を段階的に構築して維持します。構造化され、相互にリンクされた Markdown ファイルのコレクションが、あなたと生のソースの間に置かれます。」— Andrej Karpathy

              User drops a source
                      │
                      ▼
            ┌──────────────────────┐    proposedEdits
            │     wiki.ingest      │ ─────────────────────┐
            └──────────┬───────────┘                      │
                       │ creates 1 file                   ▼
                       │              ┌──────────────────────────────┐
                       ▼              │ LLM applies edits via        │
              wiki/Sources/           │  notes.edit (after-heading)  │
              <slug>.md               │  notes.edit (replace)        │
                       │              │  notes.create                │
                       │ appends      └──────────────────────────────┘
                       ▼
                 wiki/log.md

   Anytime: wiki.query   → top pages → notes.read → cited synthesis
   Periodic: wiki.lint   → orphans · broken · stale · missing · tag-drift
   Curate:   wiki.summaryMerge — add cited section to concept/entity page

保管庫内のデフォルトのレイアウト：

wiki/
├── Sources/           per-source summary pages
├── Concepts/          topic / idea pages (LLM-maintained)
├── Entities/          people / places / orgs / works
├── index.md           categorized catalog (wiki.indexRebuild)
├── log.md             greppable chronological log
└── wiki-schema.md     vault-local copy of the contract

重要な設計上の決定として、wiki.ingest は相互参照を無条件に書き換えることはありません。ファイルを 1 つだけ作成（Sources ページ）し、ファイルを 1 つ（log.md）に追記したうえで、エージェントが既存の notes.* ツールで適用する proposedEdits 配列を返します。すべての書き込みがトランスクリプトに表示されるため、LLM の幻覚は、気付かないうちに保管庫を破損させるのではなく、レビュー可能な編集として確認できます。

契約の詳細はdocs/wiki.mdをご覧ください。

Claude Code スキル

skills/にある 4 つのスキルは、自然言語に反応して起動します。 wiki-bootstrap、wiki-ingest、wiki-query、wiki-lint。~/.claude/skills/ にコピーするかシンボリックリンクを作成してください。詳しくは skills/README.mdをご覧ください。

ツール一覧

16 の名前空間にわたる 66 個の MCP ツール（v0.2.5 で約 90 個から 62 個に統合； v0.3.0 では複数の Vault をサポートする vault.* 名前空間が追加されました。全履歴については CHANGELOG を参照してください）。常に最新の一覧は docs/tool-inventory.json にあります。

クライアントの安全性に関する注釈（MCP 2025-11-25）：

MCP リソース（URI で指定可能。ツール呼び出しなしで、どのクライアントからも参照できます）：

kobsidian://wiki/index              wiki/index.md
kobsidian://wiki/log                wiki/log.md
kobsidian://wiki/schema             wiki/wiki-schema.md
kobsidian://wiki/page/{+path}       any Sources/Concepts/Entities page

MCP プロンプト（skills/ ファイルを利用しないクライアント向け）： ingest-source、answer-from-wiki、health-check-wiki。

詳細は docs/tools.md を参照してください。

設定

すべての Wiki ツールでは、呼び出しごとに wikiRoot を上書きできます。また、wiki.ingest では、ページの見出しがローカライズされている Vault（例：## Fontes）向けに、呼び出しごとの indexHeading / conceptHeading / entityHeading の上書きが可能です。ページに対象の見出しがない場合、提案は append に切り替わるため、notes.edit で適用できます。

Vault ごとの設定ファイル

ローカライズされた Wiki のフォルダー名、ファイル名、セクション見出しなど、サーバーではなく個々の Vault に属する設定は、Vault ルートにある .kobsidian.json に記述します。すべてのキーは省略可能で、対応する環境変数より優先されます。呼び出しごとのツール引数は、その両方より優先されます （呼び出しごと → .kobsidian.json → 環境変数 → デフォルト）。

{
  "$schema": "https://raw.githubusercontent.com/bezata/kObsidian/main/docs/kobsidian.config.schema.json",
  "wiki": {
    "root": "wiki",
    "sourcesDir": "Fontes",
    "staleDays": 90,
    "headings": {
      "indexSources": "Fontes",
      "indexConcepts": "Conceitos",
      "indexEntities": "Entidades",
      "conceptPage": "Discussão",
      "entityPage": "Fatos Notáveis"
    }
  }
}

不明なキーや不正な JSON は、エラーにファイルパスを含めて拒否されるため、入力ミスをすぐに確認できます。vault.current は、有効な設定を config の下に返します（またはエラーを返します）。

ドキュメント

ローカライズされたドキュメントは、簡体字中国語、 日本語、および **韓国語**で利用できます。

ロードマップ

次の2つのマイルストーンは、TODO.mdで管理されています。

• v0.4 — Obsidian LiveSync ブリッジ。 コミュニティ製プラグイン Self-Hosted LiveSync （CouchDB / S3 / R2 / WebRTC ピア）を介して、無料でエンドツーエンド暗号化された Vault にアクセスできます。これにより、Obsidian 自体が起動していなくても、 MCP クライアントからユーザーが所有する任意のマシン上の同じ Obsidian Vault に アクセスできます。
• v0.5 — Vault のセマンティクス横断検証。 2つ以上の LiveSync ペアリング済み Vault を Wiki レイヤーで照合する wiki.crossCheck ツールを追加します。互換性の契約としてプロジェクトのセマンティックバージョニング の方針に従う、新しい schema_version フロントマター項目によって制御されます。

TODO.mdには、背景、各マイルストーンのタスクの内訳、項目をそこからCHANGELOGへ 移す際のルールが記載されています。

開発

bun install
bun run typecheck
bun run lint
bun run test          # 56 tests across 14 files
bun run build         # node-target stdio.js + bun-target http.js
bun run inventory     # regenerate docs/tool-inventory.json

プロジェクトの規約については、AGENTS.mdを参照してください。

セキュリティとサプライチェーン

• すべての.mcpbリリースアセットはVirusTotalでスキャンされます。 Release ワークフローは、リリースの公開直後に crazy-max/ghaction-virustotal@v4 を介して、各kobsidian-<platform>.mcpbバンドルを VirusTotalにアップロードし、分析リンクをリリース本文に 追記します。GitHubリリースからインストールするユーザーは、実行する 前に、自分のプラットフォーム用バンドルの公開VirusTotalレポートを開いて確認できます。 メンテナーを信頼する必要はありません。

• トランスポートの強化。 Streamable HTTPはOriginを許可リストと照合して検証し （不一致の場合は403）、CORSプリフライト（OPTIONS /mcp → 204 + Access-Control-*） を実装し、MCP-Protocol-Versionを必須とするか既定値を設定し、 KOBSIDIAN_HTTP_BEARER_TOKENによるオプションのベアラー認証をサポートします。 stdioにはネットワークに接する部分がありません。

• SDKの最低バージョンを固定。 @modelcontextprotocol/sdk@^1.26.0 — GHSA-345p-7cg4-v4c7（クライアント間のレスポンス漏えい）と CVE-2026-0621（UriTemplateのReDoS）を軽減します。このリポジトリでは 1.30.0に固定しています。

• npm Trusted Publishing。 リポジトリには長期有効なNPM_TOKENを保存していません。 GitHub Actionsはタグがプッシュされるたびに有効期間の短いOIDCトークンを発行し、 npm CLIはこれを、この正確なワークフローファイル（bezata/kObsidianリポジトリの .github/workflows/release.yml）にスコープされた1回限りの公開トークンと交換します。 プロベナンス証明は自動的に付与されます。公開された各バージョンには、 そのバージョンを生成した正確なActionsの実行を示す、暗号学的に関連付けられた ビルド証明が付属します。フォーク、別のブランチ、または変更されたワークフローファイルからは 公開できません。OIDCのオーディエンスクレームが一致しないためです。

詳細はdocs/SECURITY.mdを参照してください。

互換性に関する注意事項

• プロトコルバージョン — 2025-11-25（現行のMCP仕様）。MCP-Protocol-Versionを 指定しないHTTPクライアントは、仕様に従って2025-03-26にフォールバックします。 明示的に指定された未対応バージョンには400を返します。
• Dataviewの分割 — オフラインツールは、フロントマター／インライン／リスト／ タスク／フェンス付きdataview／フェンス付きdataviewjsブロックをインデックス化します。 実行時のDQLはLocal REST APIを介してObsidian + Dataviewに委任されます。 DataviewJSはソースを保持しますが、このサーバー内では実行されません。
• Mermaid + Marp — ソースを保持した解析／編集のみです。レンダリングは クライアント側で行います。
• SDKの最低バージョン — @modelcontextprotocol/sdk@^1.26.0（GHSA-345p-7cg4-v4c7 クライアント間のレスポンス漏えいとCVE-2026-0621 UriTemplateのReDoSを軽減します）。 このリポジトリでは1.30.0に固定しています。

謝辞

• LLM Wiki のパターン — Andrej Karpathy 氏の gist。 kObsidian は、このアイデアを具体化した、ファイルシステムを優先する TypeScript 実装の 1 つです。
• Memex — Vannevar Bush 氏、As We May Think, 1945。 関連づけによる経路の概念は、この wiki の相互参照グラフが目指すものです。
• Model Context Protocol — Anthropic + Agentic AI Foundation。
• Obsidian — obsidian.md。Vault の形式が正式な仕様であり、kObsidian はそれを尊重し、移行しません。

ライセンス

MIT — LICENSE をご覧ください。貢献を歓迎します。重要な変更については、まず issue を作成してください。