Repolode
MarkusPfundstein

MarkusPfundstein/mcp-obsidian

Local REST API pluginを介して、AIアシスタントがObsidian vault内のノートを読み取り、検索、追記、削除できるMCPサーバー。

スター
4,524
フォーク
507
未解決の Issue
107
最終コミット
2 か月前

これは何?

mcp-obsidianは、Claude DesktopなどのAIクライアントをObsidian vaultに接続するModel Context Protocol(MCP)サーバーです。ObsidianのコミュニティプラグインであるLocal REST APIを介して動作するため、Obsidianを起動し、このプラグインを有効にしたうえでAPI keyを設定する必要があります。

接続すると、アシスタントはvault内のファイルやフォルダの一覧表示、ノートの内容の読み取り、全ファイルを対象とするテキスト検索、見出し・ブロック参照・frontmatterフィールドを基準にしたコンテンツの挿入、新規または既存ファイルへの追記、ファイルやディレクトリの削除を行えます。設定にはAPI keyを使い、hostとportは任意です。デフォルト値はそれぞれ127.0.0.1と27124です。

このプロジェクトはuvx、ローカルのuv環境、またはhost.docker.internal経由でホストに接続するDockerコンテナで実行できます。Python 3.11以降と、バージョン2.0未満のmcp Python SDKが必要です。

主な機能

  • 01vaultのルートまたは指定したフォルダ内のファイルやディレクトリを一覧表示します。
  • 02単一のノートの内容をすべて読み取ります。
  • 03vault内の全ファイルを対象にテキスト検索を行います。
  • 04見出し、ブロック参照、frontmatterフィールドを基準にノートへコンテンツを挿入します。
  • 05新規または既存のファイルにコンテンツを追記し、ファイルやディレクトリを削除します。

ユースケース

  • Obsidianに保存したノートの要約や解説をAIアシスタントに依頼する。
  • vault内で特定のトピックへの言及をすべて検索し、前後の文脈を確認する。
  • 既存のノートをもとに、会議の要約ノートを自動生成する。
  • AIアシスタントに個人用ナレッジベースのノートの管理や更新を任せる。

クイックスタート

  1. 1

    Obsidian Local REST APIコミュニティプラグインをインストールして有効にし、APIキーをコピーします

  2. 2

    OBS​IDIAN_API_KEY、OBSIDIAN_HOST、OBSIDIAN_PORTを設定して、MCPクライアントの設定にサーバーを追加します

  3. 3

    uvxで公開済みのサーバーを実行します

    uvx mcp-obsidian

使う前に知っておきたいこと

  • Obsidian Local REST APIコミュニティプラグインをインストールし、Obsidianで実行しておく必要があります。
  • Python 3.11以降が必要です。また、mcp依存関係はバージョン2.0未満に保つ必要があります。

収録されている特集

トピック

よくある質問

mcp-obsidian とは?
Local REST API pluginを介して、AIアシスタントがObsidian vault内のノートを読み取り、検索、追記、削除できるMCPサーバー。 mcp-obsidianは、Claude DesktopなどのAIクライアントをObsidian vaultに接続するModel Context Protocol(MCP)サーバーです。ObsidianのコミュニティプラグインであるLocal REST APIを介して動作するため、Obsidianを起動し、このプラグインを有効にしたうえでAPI keyを設定する必要があります。
mcp-obsidian は無料で使えますか?ライセンスは?
mcp-obsidian は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
mcp-obsidian は今もメンテナンスされていますか?
半年以内に更新あり。mcp-obsidian の最終コミットは 2026年8月31日 です。
mcp-obsidian は何に使えますか?
Obsidianに保存したノートの要約や解説をAIアシスタントに依頼する。 vault内で特定のトピックへの言及をすべて検索し、前後の文脈を確認する。 既存のノートをもとに、会議の要約ノートを自動生成する。 AIアシスタントに個人用ナレッジベースのノートの管理や更新を任せる。
mcp-obsidian のインストール方法は?
Obsidian Local REST APIコミュニティプラグインをインストールして有効にし、APIキーをコピーします OBS​IDIAN_API_KEY、OBSIDIAN_HOST、OBSIDIAN_PORTを設定して、MCPクライアントの設定にサーバーを追加します uvxで公開済みのサーバーを実行します: uvx mcp-obsidian
mcp-obsidian はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/MarkusPfundstein/mcp-obsidian

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト