gosidian

gosidian

AI エージェントが MCP 経由で読み取り、書き込み、推論できる Markdown ノート。

MCP サーバーを内蔵した、自己完結型の Markdown ボルトです。人間はウェブ UI で編集し、エージェントは MCP 経由でやり取りします。すべては Obsidian（およびその他すべての Markdown ツール）がネイティブに読み取れるプレーンな .md ファイルに保存されます。

掲載先： 公式 MCP Registry io.github.daniele-chiappa/gosidian、 Glama、 mcpservers.org

ブラウザーで試す

GitHub Codespaces で無料の使い捨て gosidian を起動できます。インストールは不要で、ご自身の Codespaces クォータを使用して動作します。ソースからビルドし、小さなデモ用ボルトを作成して、ウェブ UI を開きます。demo / gosidian-demo でログインしてください。

クイックスタート

docker run -d --name gosidian \
  -p 8080:8080 \
  -v "$(pwd)/vault:/vault" \
  ghcr.io/daniele-chiappa/gosidian:latest
# open http://localhost:8080, create admin, copy the MCP token from /admin/tokens
claude mcp add gosidian http://localhost:8080/mcp \
  --transport http --header "Authorization: Bearer $TOKEN"

3 つのコマンドで、Docker を起動 → ウェブ UI からトークンを作成 → エージェントを接続できます。.md ボルトは ./vault/ に保存されるため、コンテナーを停止してもファイルは残ります。

その他のインストール方法（ソース、カスタム compose、ベアメタル）： docs/getting-started.md。

gosidian とは

• Markdown ボルトです。 ノートはディスク上の .md ファイルです。同じフォルダーを Obsidian、VS Code、vim、または使い慣れた任意のエディターで開けます。ロックインはありません。.gosidian/ を削除すれば、純粋な Obsidian ボルトになります。
• MCP サーバーです。 型付きの 71 個のツールで、エージェントはセッションの初期化、ファイルの取り込み、検索、読み取り、書き込み、リンク、引き継ぎ、セルフチェック、監査を実行できます。Bearer トークンと OAuth グラントは、リクエストのたびにアカウントが読み書きできる範囲に制限されます。
• ウェブ UI です。 Vue 3 のシングルページアプリを同じバイナリーから配信します（Vite でビルドし、go:embed で埋め込み）。ノート、グラフ、検索、設定フォームは、タイル型の「plancia」ワークスペース内のウィンドウとして開きます。全文検索、バックリンク、グラフビュー、ライブプレビュー付きエディター、監査証跡、トークンとユーザーを管理する管理ページを備えています。

3 つのビューはすべて、ディスク上の同じファイルを参照します。SQLite FTS5 インデックスはキャッシュなので、削除しても再構築されます。

対象ユーザー

• 永続的な構造化メモリーを必要とするエージェントを接続する AI エンジニア：ノート、計画、スキル、ADR、引き継ぎ、監査など。
• すでに信頼しているボルトに、プログラムから操作できるレイヤーを追加したい Obsidian ユーザー。
• 1 つのボルトを共有する チーム：プロジェクトごとの可視性と、アカウントやチームへのグラント、専用プロジェクトを持つ制限付きの新規アカウント、所有者の権限を超えない各エージェント用のセルフサービス型トークンを利用できます。

X ではなく gosidian を選ぶ理由

• RAG／ベクトル検索との比較：gosidian は、エージェントのメモリーを 識別情報（パス、タグ、frontmatter、バックリンク）で取得します。これは、エージェントの作業メモリーには類似性検索より予測しやすい方法です。ノートに対するセマンティック検索は意図的に後回しにしています。詳しくはADR-007 の理由をご覧ください。プロジェクトの ドキュメント（マニュアル、レポート、スキャンデータ）に対する RAG は別の話であり、gosidian の実験的な機能の一部です。
• Obsidian Sync との比較：Sync は人間が使うデバイス間でボルトを同期します。gosidian は同じボルトに、型付きの自動化インターフェイス（MCP）を追加します。競合するものではなく、相互補完するものです。
• Notion／Roam との比較：ホスト型またはプロプライエタリーな形式のため、移行にはプロジェクトとしての作業が必要です。gosidian のボルトは、どこへでも持ち運べる .md ファイルです。

詳しくはFAQをご覧ください。

類似プロジェクトとの比較

「Markdown の Vault ＋エージェント」の分野は、競合がひしめいています。2026 年 9 月時点で gosidian が位置する領域と、そうでない領域を紹介します。

注目しているもの	それらのプロジェクトが提供するもの	gosidian との違い
Obsidian MCP ブリッジ — mcp-obsidian、obsidian-local-rest-api、Obsidian CLI のラッパー	起動中の Obsidian デスクトップアプリを MCP 経由でエージェントに公開します。	ヘッドレスサーバーです。Obsidian のプロセスは不要で、マシン上またはコンテナ内で動作し、役割、プロジェクトごとの可視性と権限付与（アカウントとチーム）、アカウントごとに範囲を限定したトークン、監査証跡を備えたマルチユーザー対応です。Vault は通常の Obsidian Vault のままです。
Markdown メモリサーバー — basic-memory、mcp-vault	同じく「データベースではなくファイル」という考え方を採用し、通常はハイブリッドセマンティック検索、クラウドプラン、または WebDAV 同期を追加します。	完全な Web UI、実際のマルチユーザー対応、エージェントの引き継ぎバス、サーバーが提供する作業手法（バージョン管理された指示、lint、古くなった情報の検出）を備えています。設計上、セマンティック検索は行わず（ADR-007）、ホスト型プランもありません。
クライアントサイドの Wiki スキル — obsidian-wiki と「LLM Wiki」パターン	エージェントがローカルで実行するスラッシュコマンドで、Wiki を作成・管理します。サーバーも認証も UI もありません。	同じパターンをサーバーサイドかつエージェントに依存しない形で実装しています。1 回の呼び出しでひな形を作成し、起動時に指示を提供し、引き継ぎと監査に対応します。補完的に、これらのスキルは gosidian の Vault でも動作します。
エージェントメモリサービス — mem0、agentmemory、mcp-memory-service	埋め込み、想起ベンチマーク、自動取得フックを備えた、不透明なストアとしてのメモリです。	メモリは、人間が Obsidian または Web UI で読める Markdown です。埋め込みは使わず、ID とグラフによって取得し、言語モデルを呼び出すのは有効にしたパイプラインのみです。自動取得はバイナリ内ではなく、Claude Code フック（contrib/claude-code/：セッション開始時にコンテキストを注入し、コンパクション時と終了時にセッションの要約を作成）を通じて行います。想起に関する公開済みの数値はまだありません。
コミュニティ製 MCP サーバーを備えたノートアプリ — SilverBullet、Trilium、SiYuan	成熟したエディター、モバイルアプリ、場合によってはリアルタイム共同編集を備えています。MCP は、API の上にサードパーティ製サーバーを追加する形で提供されます。	MCP を最優先としており、サーバーはバイナリに組み込まれ、UI と同じログイン、役割、監査のもとで動作します。モバイルアプリ、リアルタイム共同編集、WYSIWYG エディターはありません。

率直に言うと、課題として挙がる順に、ノートを対象にしたセマンティック検索／ハイブリッド検索（先送りされています。FAQ を参照してください。ドキュメントには実験的な RAG があります）、git 以外でのモバイル同期、リアルタイム共同編集、ホスト型サービスがあります。ロードマップで、これらのうち計画されているものを確認できます。

主な機能

• 単一バイナリ、50 MB 以下、Alpine ベースの Docker イメージ
• Web UI：バイナリに組み込まれた Vue 3 SPA（Vite、Pinia、Tailwind、CodeMirror、Cytoscape）。エディターとライブプレビュー、サイドバー、検索、グラフ表示、添付ファイル、監査ログ、管理ページを備えています
• Plancia タイリングウィンドウマネージャー（niri スタイル）：ノート、グラフ、検索、設定フォームを、サイズ変更可能なウィンドウとして横並びで開けます。ワークスペースは水平方向にスクロールでき、URL から復元できます
• Streamable HTTP による MCP サーバー（従来の HTTP+SSE も引き続き利用可能）、型付きツール 71 種
• スコープ（read / write）とプロジェクト単位の制限を備えたベアラートークン。オーケストレーター向けの複数プロジェクト対応トークンも利用できます。アカウントが所有するすべてのトークンは、各リクエストでそのアカウントが読み書きできる範囲に制限されます。アカウントは独自のトークンを発行し（inherit はアカウントのアクセス権を継承し、custom は一部の権限に固定）、ユーザーを無効化するとトークンも連鎖的に失効します
• エージェントオーケストレーションバス：原子的な取得／完了ライフサイクルを持つ引き継ぎノート、サーバーがスタンプする ID、変更をロングポーリングする memory_wait_changes フィードを備えています。すべてをプレーンな Markdown のまま保つ、最小構成のマルチエージェントタスクキューです
• ロール（Admin / User / Read-only）を上限とする複数ユーザーの Web ログイン。読み取りにはプロジェクト単位の公開範囲（private / internal / public）を、その他のすべての操作にはアカウントとチームへの権限付与（read / write / admin）を適用し、プロジェクト管理者に委任できます。新規アカウントは制限付きで開始し、個人用プロジェクトが付与されます。サインアップは招待制（TTL は 24 時間）です
• オプションの TOTP 二要素認証（全体モード＋ユーザー単位の上書き）と、ゲストの自動プロビジョニングに対応した LDAP / Active Directory ログイン
• オプトイン方式の OAuth 2.1 認可サーバー。claude.ai / Claude Desktop のカスタムコネクター、ChatGPT コネクター、Claude Code のブラウザーログインで、同意画面を通じて専用トークンを取得できます。ベアラートークンを貼り付ける必要はありません
• Claude Code フック（contrib/claude-code/）：各セッション開始時にプロジェクトの hot.md のフォーカス内容を注入し、コンパクション時と終了時にセッションの要約を Vault に追加します。LLM は使わず、POST /mcp/append を使用し、セッションをブロックしません
• オプションの Git 同期（コミットのデバウンス、トークン認証によるプッシュ）
• SQLite FTS5 の全文検索＋ETag による楽観的ロック
• サンドボックス化された iframe でレンダリングする、.html ノートの標準サポート（既定ではオフ。プロジェクトごとにオプトイン）
• ウィキリンクグラフのグラフ分析：memory_hubs（リンク数が最多のノート）と memory_path（2 つのノート間の最短経路）
• オプトイン方式の自己改善ループ：エージェントがトークンごとに使用上の摩擦に関する知見を記録します。既定ではオフです
• Web UI から任意の Markdown ノートを直接印刷／PDF として保存
• 国際化（IT と EN は完成済み。ES / FR / DE は基盤のみ）
• ライト／ダークテーマのプリセット（Catppuccin、Tokyo Night、Solarized）＋カスタムパレット
• こだわりのある Karpathy-Wiki-Stack プロジェクト構成と、1 回の呼び出しで完了するスキャフォールディング
• プロジェクト間で共有するスキル、エージェント、スキャフォールドテンプレート向けのオプションのグローバルプロジェクト（プロジェクトごとにオプトイン。ローカル設定がグローバル設定より優先）

実験的機能：パイプライン、プラグイン、RAG、エージェント

これらの機能は新しく、デフォルトでは無効で、リリースごとにまだ変更されています。設定、ノードの種類、注記は変更されることがあり、その場合は docs/upgrading.md に記載されます。上記のコア機能（ボルト、MCP サーバー、Web UI）はこれらに依存せず、無効のままインストールすれば、これらの機能は一切表示されません。

• パイプライン（docs/pipelines.md）：type: pipeline のノートで、ファイルの到着、コミット、チャットメッセージ、エージェントやサービスからの呼び出し、時刻など、何かが起きたときにサーバーが実行します。ノードはノートを読み書きし、言語モデル（ローカルまたはリモートの、OpenAI 互換エンドポイントなら何でも）を呼び出し、スクリプトを実行したり、人の回答を待ったりします。すべてのパイプラインでキューは共通ですが、プラグイン、プロバイダー、共有リソース（GPU など）ごとに上限が設けられ、プロジェクト間で公平に処理されます。テキストまたはビジュアルエディターで編集できます。[pipelines] enabled = true を設定し、プロジェクトで有効にした場合にのみ実行されます。
• プラグイン（docs/plugins.md、gosidian-plugins）：gosidian の隣で動作する MCP サーバーで、それぞれがコンテナ内で実行され、パイプラインにノードの種類を、エージェントにツールを追加します。プラグインは、所有者がマニフェストを承認した後にのみ実行され、ボルトを見ることはなく、パイプラインから渡されたファイルだけを扱います。これまでに公開されたプラグイン：
  • ドキュメント：docling（PDF、Office ファイル、HTML を Markdown に変換）、ocr（ビジョンモデルを使ってスキャンを処理）、images；
  • データ：database（pgvector、Qdrant、SQLite を使って PostgreSQL に埋め込みを保存）、storage（ファイルの保存元として Nextcloud、S3、Google Drive を利用）；
  • 人との連携：chat（あらゆる Web ページにウィジェットとして設置できるボット）、notify（Telegram、ntfy、メールで、回答が必要な質問を送信）；
  • エージェントとコード：実行エンジンとしての claude（Claude Code）と pi（pi.dev）、exec（サンドボックス内でスクリプトを実行）、preview（誰にも推測されないアドレスで静的ビルドを公開）。
• IN フォルダー（docs/in.md）：プロジェクトで作業するファイルを、それぞれの名前のまま置く場所です。Web UI から再開可能な分割方式でアップロードするか、エージェントから送信するか、リモートストアから読み込むことができ、パイプラインがこれらをノートに変換します。
• プロジェクトのドキュメントを対象にした RAG（docs/chat.md、docs/rag-benchmarks.md）：プロジェクトテンプレート rag は、IN フォルダー内のファイルを変換し、ノートを段落に分割して埋め込みとともに保存し、出典を引用しながら質問に回答します。ボット（type: chat）から質問でき、専用ページまたはあらゆるサイトに設置したウィジェットで利用できます。ViDoRe V3 の一般公開されている8つのコーパス（質問数14,514件）を使い、ローカルモデルで測定した結果は、段落検索の NDCG@10 が52.7、良好と判定された回答の割合が57％、回答時間の中央値が5.5秒でした。エージェント自身のメモリーは引き続き ID による検索を使います。RAG はドキュメント向けであり、ボルトのノート向けではありません。
• エージェントチーム（docs/agents.md）：type: team のノートに、コーディネーター、ライター、開発者、レビュー担当者などの役割を定義します。それぞれがパイプラインによってタスクを実行するエージェント（プラグイン経由の Claude Code または pi）であり、タスクはプロジェクトのノートです。gosidian はタスクを割り当て、各エージェントの変更内容が役割ごとのパスとチェック項目に沿っているかを確認し、マージの前に人の承認を求め、1日の予算に対するコストを計上します。パイロットでは、5人分のトレーニング計画と小規模な Web アプリという1つの目標に対して、同じチームを何度も実行します。
• Compose プリセット（docs/deployment.md）：deploy/presets/ から1つの .env で、RAG チェーン（docling、images、Qdrant を使う database プラグイン、chat）を含む gosidian を起動できます。

ドキュメント

領域	まずはこちら
インストールと設定	はじめに、設定、デプロイ、アップグレード
MCP 連携	概要、ツール一覧、認証、クライアントのセットアップ、エージェントのパターン、Claude Code フック
Web UI	概要、エディター、認証とロール、設定
Vault	形式、規約、複数プロジェクト、グローバルプロジェクト、Obsidian との互換性
試験的機能	パイプライン、プラグイン、IN フォルダー、ボット、エージェントチーム、RAG ベンチマーク
内部情報	アーキテクチャ、開発
よくある質問	FAQ

全項目の一覧：docs/README.md。

コントリビューション

コントリビューションを歓迎します。ワークフロー、テストの要件、翻訳ガイドラインについては、CONTRIBUTING.mdをご覧ください。

セキュリティ

セキュリティ上の問題は非公開で報告してください。報告手順については、SECURITY.mdをご覧ください。

ライセンス

MIT Licenseのもとで公開されています。

関連項目

• PROJECT-STORY.md — プロジェクトの成り立ち、設計思想、Obsidian／Logseq／RAG ベースのナレッジスタックとの比較。
• CHANGELOG.md — リリース履歴。