Obsidian Vault Management Server integrates the Obsidian note-taking application with AI assistants through the Model Context Protocol. It enables programmatic management of Markdown-based knowledge bases stored in Obsidian vaults. Key capabilities include: - Template-driven note creation with variable substitution for consistent note formatting - Reading and updating existing notes within the vault - Tag management and full-text file search across the knowledge base - Advanced link management including wiki link creation between notes - Broken link detection and repair suggestions to maintain vault integrity - Backlink analysis to understand note relationships and graph structure - Automatic Map of Contents (MOC) generation for organizing related notes - Directory and file system navigation within the vault structure

Obsidian MCP Server

English | 日本語

ObsidianとModel Context Protocol (MCP)を連携させるサーバーです。

機能

基本機能

リンク管理機能（高優先度機能）

セットアップ

1. 依存関係のインストール:

   npm install
   

2. TypeScriptのコンパイル:

   npm run build
   

3. 環境変数の設定:

   export OBSIDIAN_VAULT_PATH="/path/to/your/obsidian/vault"
   export OBSIDIAN_TEMPLATE_DIR="TEMPLATE"
   

4. サーバーの起動:

   npm start
   

MCP設定方法

Claude Desktop での設定

1. 設定ファイルの場所を確認: - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/claude/claude_desktop_config.json

2. プロジェクトのパスを確認:

   pwd
   

3. Node.jsのパスを確認:

   which node
   

4. 設定ファイルを編集: 設定ファイルに以下の設定を追加してください：

基本設定:

   {
     "mcpServers": {
       "obsidian": {
         "command": "node",
         "args": ["/path/to/obsidian-mcp-server/dist/server.js"],
         "env": {
           "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault",
           "OBSIDIAN_TEMPLATE_DIR": "TEMPLATE"
         }
       }
     }
   }
   

設定例:

   {
     "mcpServers": {
       "obsidian": {
         "command": "node",
         "args": ["/Users/username/Projects/obsidian-mcp-server/dist/server.js"],
         "env": {
           "OBSIDIAN_VAULT_PATH": "/Users/username/Documents/MyVault",
           "OBSIDIAN_TEMPLATE_DIR": "TEMPLATE"
         }
       }
     }
   }
   

トラブルシューティング用（Node.jsパスを明示的に指定）:

   {
     "mcpServers": {
       "obsidian": {
         "command": "/usr/local/bin/node",
         "args": ["/path/to/obsidian-mcp-server/dist/server.js"],
         "env": {
           "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault",
           "OBSIDIAN_TEMPLATE_DIR": "TEMPLATE"
         }
       }
     }
   }
   

重要な置き換えポイント: - /path/to/obsidian-mcp-server/dist/server.js → 実際のプロジェクトパス - /path/to/your/obsidian/vault → 実際のObsidianボルトのパス - /usr/local/bin/node → which nodeで確認したNode.jsのパス

5. Claude Desktop を再起動

他のMCPクライアントでの設定

他のMCPクライアントを使用する場合は、以下の設定を参考にしてください:

利用可能なツール

1. create_note_from_template

パラメータ:

2. list_templates

パラメータ: なし

3. read_note

パラメータ:

4. update_note

パラメータ:

5. list_tags

パラメータ: なし

6. rename_tag

パラメータ:

7. search_files

パラメータ:

リンク管理ツール（高優先度機能）

8. link_notes

パラメータ:

機能:

9. find_broken_links

パラメータ: なし

機能:

戻り値:

{
  "brokenLinks": [
    {
      "sourceFile": "notes/example.md",
      "linkText": "Missing Note",
      "targetPath": "missing-note",
      "lineNumber": 15,
      "suggestions": ["similar-note", "missing-note-backup"]
    }
  ],
  "totalCount": 1
}

10. analyze_backlinks

パラメータ:

機能:

戻り値:

{
  "targetNote": "important-concept.md",
  "backlinks": [
    {
      "sourceFile": "notes/research.md",
      "context": "この概念は[[important-concept]]として知られている",
      "linkType": "wiki"
    }
  ],
  "relatedNotes": ["notes/research.md"],
  "metrics": {
    "popularity": 5,
    "centrality": 0.1
  }
}

11. create_moc

パラメータ: