Obsidian Turbocharged

obsidian-tc

Obsidian をさらに強化 — MCP 経由で、ガバナンスが適用されたエージェント対応の Vault アクセスを実現します。

概要

obsidian-tc は、Obsidian Vault 向けの、ガバナンスが適用されたエージェント対応の Model Context Protocol サーバーです。人間にもエージェントにもご利用いただけます。何年分ものノートにファイルシステムから直接アクセスさせる代わりに、すべてのツール呼び出しを認証、フォルダー ACL、読み取り専用キルスイッチ、破壊的操作に対する HITL 確認、監査ログを含む単一のパイプラインで処理します。さらに、融合型検索（全文、ベクトル、グラフ）と、エピソード、減衰、忘却を扱うメモリー層を追加します。これらは同じ ACL のもとで Vault 内に存在します。 すべてのドメインを網羅する充実したツール群を提供します（デフォルトではすべて表示され、オプトインの profile: "core" を指定すると小規模なセットになります）。3 ツールのディスカバリーファサードと標準の search／fetch ペアを通じて利用でき、ツールカタログに一覧があります。製品の狙い：docs/WHY.md。

60 秒で開始

インストール不要：

npx obsidian-tc /path/to/vault

すべてのノートツールと字句検索をすぐに利用できます。セマンティック検索はバンドルされたエンベッダーをデフォルトで使用します。利用できるインストール方法については、使用に適さないケースをご覧ください。

複数の Vault、認証、または ACL を利用する場合は、設定ファイルを使用してください。

npm install -g obsidian-tc
obsidian-tc ./obsidian-tc.config.json   # Node >= 24 or Bun >= 1.1

デフォルトの local エンベッダーはオプトイン形式のインストールのため、npm install -g obsidian-tc ではインストールされません。使用するには、同じバージョンをインストールしてください：npm install -g @the-40-thieves/obsidian-tc-embedder-local@<same version>（プロジェクトにインストールする場合は -g を外します）。または、obsidian-tc setup の案内に従ってインストールできます。Ollama とホスト型の埋め込みプロバイダーにはローカルエンベッダーは不要です。エンベッダーがない場合、セマンティック検索は無効になりますが、それ以外の機能は引き続き動作します。

Docker イメージ、.mcpb バンドル、スタンドアロンバイナリとしても提供しています。詳細： docs/QUICKSTART.md。

obsidian-tc の使用に適さないケース

率直なご案内です。多くの製品よりも高機能で、そのぶん構成も大がかりです。

• 可能な限り小さな構成、読み取り専用アクセス、または MCP をまったく使わない場合。 1 つの Vault に対して信頼できる人間が 1 人で使う場合や、読み取り専用のラッパー、Obsidian URI／Local REST API プラグインで十分かもしれません。比較の全文をご覧ください。
• セットアップ不要で、ソースコードをチェックアウトして使う場合のみ。 Vault はディスクから読み込まれます。セマンティック検索ではオフラインのエンベッダーがデフォルトで使われます。公開されるまでは、npm／Docker ではプロバイダーを明示的に指定する必要があります。埋め込みをご覧ください。
• 設定不要の利用では、認証／ACL がありません。 obsidian-tc /path/to/vault は認証なし、フォルダー ACL なしで起動します。ローカルでのみ使う場合に限り問題ありません。ガバナンスはオプトインです。詳しくはSECURITY.mdをご覧ください。
• AGPL-3.0 のネットワークコピーレフト条項。 寛容なライセンスではありません。商用ライセンスが用意されている場合があります。ライセンスをご覧ください。
• メンテナーが 1 人のプロジェクトです。
• Obsidian 内ですべてを完結させたい場合、または Vault に依存しないメモリーが必要な場合。 上記の比較をご覧ください。

別の MCP サーバーからの移行について：docs/CUTOVER.md。

比較

Obsidian MCP プロジェクトの多くは、Vault アクセス用サーバー、検索エンジン、またはメモリエンジンのいずれかで、複数の役割を担うものはほとんどありません。obsidian-tc は、私たちの知る限り、3つすべてを備えた唯一のプロジェクトです。メモリーはVault 内に保存され、ほかのすべての書き込みと同じ ACL の対象となります。9プロジェクトの全比較表と「他のプロジェクトが優れている点」をご覧ください。

	ツール	グループ	用途
obsidian-tc	全機能（3ツールのファサード）	3つすべて	ガバナンスされたアクセス＋検索＋Vault 内メモリー
obsidian-local-rest-api	18	アクセス	Obsidian 独自の組み込み MCP サーバー。ベアラートークンキー1つで、ACL はありません
basic-memory	約35	メモリー	別個のポータブルな Markdown KB にエンティティ／関係を保存

---

詳細

目次

TC Bridge · ステータス · アーキテクチャ · インターフェース · Claude Code / Cursor / VS Code · ドキュメント · 商標 · ライセンス · 貢献

TC Bridge：Obsidian 用コンパニオンプラグイン

Obsidian のプラグインブラウザーからここにアクセスした場合、TC Bridge の掲載先がここになっているのは、このリポジトリにプラグインが含まれているためです。ただし、これは小規模なオプションのブリッジであり、上記のサーバーとは異なります。Local REST API を拡張し、Obsidian 専用の機能（Templater、Dataview、Tasks、Excalidraw、Git、Remotely Save）用のエンドポイントを提供します。ファイルシステムレベルの機能は、プラグインなしですべて利用できます。

• 最初に Local REST API をインストールしてください。TC Bridge はそのベアラートークン認証を再利用し、デスクトップ専用です。サーバーは別途インストールします（60秒で開始）。ブリッジに接続するには、Vault の設定に restApiUrl／restApiKey が必要です （手順6）。このキーは Vault のルートパスワードに相当します。まず信頼境界をお読みください。
• **以前の名称は「Obsidian Turbocharged」でした。**設定は初回読み込み時に移行されます。詳細は packages/plugin/README.mdをご覧ください。

ステータス

リリース済み — v1.33.1。来歴署名付きパッケージとして npm に公開済みで、コンテナーイメージは GHCR にあります。 マイルストーン：ロードマップ、リリース： CHANGELOG.md。

検索の変更は、主張するのではなく測定しています。ランキング変更のたびに、非公開のゴールデンセットを対象とした統計的なリリース基準を通過する必要があります。この README に以前掲載していた主要な数値は、再現できないため2026-08-07に取り下げました。詳細な説明と、その後に公開コーパスで得られた結果については、 docs/EVALUATION.mdをご覧ください。

アーキテクチャ

複数言語を使用するモノレポです。

パッケージ	言語	用途
packages/server	TypeScript (Bun)	MCP レイヤー、認証、ルーティング、ツール、プラグインブリッジ
packages/plugin	TypeScript	Local REST API を拡張する Obsidian 連携プラグイン
packages/shared	TypeScript	共有 Zod スキーマと型
packages/native	Rust (napi-rs)	オプションの高速化、純粋な JavaScript によるフォールバック

ディスパッチパイプラインとパッケージ構成の詳細については、ARCHITECTURE.md をご覧ください。

すべての機能は、宣言されたアクセススコープに従うツールとして提供されます。読み取りツール（read_note、 search_vault、get_backlinks など）は、Vault を変更しません。書き込みツールでは、ノート全体および 部分的な編集が可能です。write_note、append_note、patch_note（見出しやブロックを基準にした編集）、 update_frontmatter、タグとリンクの管理が含まれます。削除と移動（delete_note、move_note）、 一括操作（bulk_set_property）、実行（execute_command）、管理（add_vault、reload_vault）は、 それぞれ別個のスコープクラスで制御されます。アクセススコープ別に分類され、ツールレジストリから生成される 常に最新の完全な一覧は、ツールカタログをご覧ください。

インターフェース：制御対象のあらゆる機能を5つのツールで利用

デフォルトでは、サーバーが公開するツールは164個の一覧ではなく、わずか5つです。3つのメタツール find_capability、describe_capability、call_capability（名前を指定して呼び出し、直接呼び出しと同じパイプラインを使用）と、 ChatGPT のディープリサーチに必要な標準の search および fetch ツールです。toolFacade.mode で triad（デフォルト）、domain、flat のいずれかを選択します。廃止された auto もあります。 境界のみが変わり、ゲートは迂回されません。クライアントごとの推奨事項については、MCP クライアントをご覧ください。

Claude Code、Cursor、VS Code へのインストール

Claude Code プラグイン（npx -y obsidian-tc を起動し、有効化時に設定ファイルのパスを尋ねます）：

claude plugin marketplace add The-40-Thieves/obsidian-tc
claude plugin install obsidian-tc@the-40-thieves

Grok Build と Muse Code（1.4.0 以降）は同じマーケットプレイスを参照します。詳細については、 インストールをご覧ください。

VS Code Insiders にインストール

手動で設定する場合、Cursor（mcpServers）／VS Code（servers）で同じオブジェクトを使用します： {"command": "npx", "args": ["-y", "obsidian-tc"], "env": {"OBSIDIAN_TC_CONFIG": "/ABS/config.json"}}。 .mcpb バンドル（bun run bundle）を使って Claude Desktop やその他の MCPB ホストにもインストールできます。 claude.ai と ChatGPT（リモート HTTP）については、配布をご覧ください。

ドキュメント

• docs/QUICKSTART.md — インストールから初めてのガバナンス対象の書き込みまで、約5分
• docs/WHY.md / SECURITY.md — 脅威モデル、ガバナンス
• docs/CUTOVER.md — 別の Obsidian MCP サーバーからの移行
• docs/EVALUATION.md — 検索の変更を測定する方法
• ARCHITECTURE.md — ディスパッチパイプライン、パッケージ構成
• ドキュメントサイト：https://obsidian-tc.the40thieves.io（「Getting Started」に詳細な比較を掲載）

商標

obsidian-tc は独立したコミュニティ開発プロジェクトであり、Obsidian またはその開発元である Dynalist Inc. とは提携しておらず、承認も受けていません。「Obsidian」は Dynalist Inc. の商標であり、指示的な用途に限り使用しています。 公式アプリ：obsidian.md。

ライセンス

AGPL-3.0-only。LICENSE とライセンスに関する FAQをご覧ください。商用利用の例外が認められる場合があります — ディスカッションを開始してください。 貢献はDCOに基づきます。CONTRIBUTING.mdでサインオフしてください。

貢献

CONTRIBUTING.md / 行動規範をご覧ください。 セキュリティ：SECURITY.md。