Obsidian MCP Local

Node.js + TypeScriptで構築されたMCPローカルサーバーで、ObsidianボルトをVS Code + GitHub Copilotに公開します。

ボルト内のMarkdownノートの読み書きに焦点を当て、stdio経由でのローカル利用を想定しています。

機能

利用可能なツール

• search_notes(query)

  • ノートのパス、フロントマター、コンテンツ内のテキストを検索します

  • 小さな抜粋を含むランク付けされた結果を返します

• get_note(path)

  • ボルト内のノートを開きます

  • path、frontmatter、contentを返します

• create_note(path, content, overwrite?)

  • 新しいノートを作成します

  • オプションで既存のノートを上書きできます

• append_to_note(path, content)

  • 既存のノートの末尾にコンテンツを追加します

• find_by_tag(tag)

  • タグでノートを検索します

  • フロントマターのtagsおよびコンテンツ内のインラインタグをサポートしています

実装されているルール

• 設定されたボルト内のファイルのみにアクセスします

• 以下のディレクトリを無視します:

  • .obsidian

  • .git

  • node_modules

• .mdファイルのみを扱います

• ベースディレクトリ外へのアクセスを防ぐためにパスを正規化します

プロジェクト構造

obsidian-mcp-local/
  package.json
  tsconfig.json
  README.md
  .vscode/
    mcp.example.json
  src/
    index.ts

前提条件

• Node.js 20+

• npm

• GitHub Copilotを搭載したVS Code

• ローカルのObsidianボルト

インストール

プロジェクトディレクトリにて:

npm install
npm run build

開発用:

npm run dev

コンパイル済みバージョンを実行する場合:

npm start

VS Codeでの使用方法

1. プロジェクトのコンパイル

npm install
npm run build

2. VS CodeのMCP設定ファイルの調整

.vscode/mcp.example.jsonの内容を、Copilotを使用するワークスペースの.vscode/mcp.jsonにコピーします。

例:

{
  "servers": {
    "obsidian-local-vault": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/caminho/para/obsidian-mcp-local/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
      }
    }
  }
}

3. パスの更新

以下を置き換えてください:

• C:/caminho/para/obsidian-mcp-local/dist/index.js

• D:/Obsidian/Vault

これらを実際のPC上のパスに書き換えます。

4. VS Codeの再起動/リロード

その後、CopilotがMCPサーバーを検出するはずです。

Copilot Chatでの使用例

• 「ボルトから.NETに関するノートを探して」

• 「ノート knowledge/backend/dotnet.md を開いて」

• 「inbox/ideias-mcp.md に議論した内容の要約をノートとして作成して」

• 「ノート daily/2026-04-06.md の末尾に - testar MCP local というテキストを追加して」

• 「#arquitetura タグが付いたノートを見つけて」

今後の改善案

• append_under_heading

• [[wikilinks]] の解析

• get_backlinks(note)

• 高速検索のためのSQLiteインデックス

• 書き込み用フォルダのホワイトリスト (inbox/, daily/, scratch/)

• 特定フォルダへの書き込み制限設定

重要な注意点

• このプロジェクトはObsidianが起動している必要はありません。

• ボルトのファイルに対して直接操作を行います。

• ObsidianとVS Codeの両方で書き込みを有効にする場合、競合制御はユーザーの責任となります。

• 現在のプロジェクトは、ボルトがローカルのMarkdownフォルダであることを前提としています。

メインファイル

実装は以下にあります:

• src/index.ts

ライセンス

個人利用 / カスタマイズ用のベースとして。