Obsidian MCP Server

English | 日本語

ObsidianModel Context Protocol (MCP)連携

機能

基本機能

• 使用作成
• 読込更新
• 一覧取得
• 管理検索
• 検索

管理機能高優先度機能

• 間作成
• 壊検出修復支援
• 分析構造把握
• Map of Contents目次自動生成

1. 依存関係:

   npm install
   

2. TypeScript:

   npm run build
   

3. 環境変数設定:

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

   注意: OBSIDIAN_VAULT_PATH実際Obsidian置換

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
   

   Node.js確認

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使用場合以下設定参考:

• ****: node /path/to/obsidian-mcp-server/dist/server.js
• 環境変数:
  • OBSIDIAN_VAULT_PATH: Obsidian
  • OBSIDIAN_TEMPLATE_DIR: 名

利用可能

1. create_note_from_template

使用Obsidian作成

:

• templateName (必須): TEMPLATE内名.md拡張子
• variables (必須): 内変数置換
• outputPath (必須): 保存先vault相対
• overwrite (): 既存上書: false

2. list_templates

TEMPLATE内利用可能一覧取得

:

3. read_note

Obsidian内容読込

:

• notePath (必須): vault相対

4. update_note

Obsidian内容更新

:

• notePath (必須): vault相対
• content (必須): 新内容

5. list_tags

Obsidian内一覧表示

:

6. rename_tag

Obsidian内一括

:

• oldTag (必須): 変更前名#付#
• newTag (必須): 変更後名#付#

7. search_files

Obsidian内検索

:

• searchPath (): 検索開始vault相対省略時
• pattern (): 検索名一部省略時全

管理高優先度機能

8. link_notes

間作成

:

• sourceNote (必須): 元vault相対
• targetNote (必須): 先vault相対
• linkText (): 表示省略時名
• insertPosition (): 挿入位置'end''cursor'行番号: 'end'

機能:

• 存在
• 重複検出警告
• 相対解決
• 形式 [[|表示]] 挿入

9. find_broken_links

壊検出修復支援行

:

機能:

• [[]] Markdown []() 両方対応
• 検索修復候補提示
• 大文字小文字特殊文字差異考慮
• 行番号周辺表示

戻値:

{
  "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 (必須): 分析対象vault相対

機能:

• 指定検出
• 周辺抽出
• 関連特定
• 人気度中心性計算

戻値:

{
  "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

Map of Contents目次自動生成

:

• title (必須): MOC
• targetPath (必須): MOC保存先vault相対
• sourcePattern (): 対象省略時全
• groupBy (): 化方法'tag''folder''none': 'none'
• includeDescription (): 説明含: false

機能:

• 選択
• 化
• YAML frontmatter説明自動抽出
• 形式目次生成

生成例:

# 関連

*Map of Contents自動生成 - 2024-01-15*

## #project
- [[project-planning|計画]] - 新機能企画設計
- [[project-timeline|]] - 開発

## #development  
- [[api-design|API設計]] - RESTful API仕様書
- [[database-schema|設計]] - 構造関係性

使用方法

作成例

TEMPLATE/meeting-notes.md:

---
description: "会議作成"
---

# {{title}}

**日時**: {{date}} {{time}}
**参加者**: {{participants}}

## 議題
{{agenda}}

## 議事録
{{notes}}

## 次回
{{action_items}}

MCP経由使用

基本使用例

// 作成
await mcp.callTool('create_note_from_template', {
  templateName: 'meeting-notes',
  variables: {
    title: '計画会議',
    participants: '田中佐藤山田',
    agenda: '新機能仕様検討',
    notes: '',
    action_items: ''
  },
  outputPath: 'meetings/2024-01-15-project-planning.md'
});

// 間作成
await mcp.callTool('link_notes', {
  sourceNote: 'meetings/2024-01-15-project-planning.md',
  targetNote: 'projects/new-feature.md',
  linkText: '新機能',
  insertPosition: 'end'
});

管理使用例

// 壊検出
const brokenLinks = await mcp.callTool('find_broken_links');

// 分析
const backlinks = await mcp.callTool('analyze_backlinks', {
  targetNote: 'concepts/important-concept.md'
});

// Map of Contents作成
await mcp.callTool('create_moc', {
  title: '関連',
  targetPath: 'index/project-moc.md',
  sourcePattern: 'project',
  groupBy: 'tag',
  includeDescription: true
});

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.