Obsidian Memory MCP

🚀 Obsidian Memory MCP

Obsidian Memory MCPは、AIの記憶をMarkdownファイルとして保存し、Obsidianのグラフビューで視覚化するためのMCPサーバーです。これにより、AIの知識構造を直感的に把握することができます。

🚀 クイックスタート

このサーバーを使用するには、まずインストールと設定を行い、その後Obsidianと連携して使用します。以下に詳細な手順を示します。

✨ 主な機能

• Markdown形式での保存：各エンティティを個別の.mdファイルとして保存します。
• Obsidianとの統合：グラフビューでの視覚化に[[link]]構文を使用します。
• 知識グラフ：エンティティ、関係、観測結果を保存します。
• 検索機能：保存されたすべての記憶をクエリできます。
• YAMLヘッダー：メタデータをヘッダーに保存します。

📦 インストール

サーバーのクローンとインストール

git clone https://github.com/YuNaga224/obsidian-memory-mcp.git
cd obsidian-memory-mcp
npm install
npm run build

Claude Desktopでの設定

{
  "mcpServers": {
    "obsidian-memory": {
      "command": "node",
      "args": ["/full/path/to/obsidian-memory-mcp/dist/index.js"],
      "env": {
        "MEMORY_DIR": "/path/to/your/obsidian/vault"
      }
    }
  }
}

💻 使用例

基本的な使用法

Obsidianで知識グラフを表示するには、以下の手順を実行します。

1. 上記のいずれかのオプションでClaude Desktopを設定します。
2. Claude Desktopを再起動します。
3. MCPメモリツールを使用してエンティティと関係を作成します。
4. Obsidianを開き、グラフを表示します。

知識グラフは以下のように視覚化されます。

• エンティティファイルがノードとなります。
• [[links]]がエッジとなります。
• 異なるエンティティタイプには異なる色が付けられます（Obsidianで設定されている場合）。

📚 ドキュメント

概要

このプロジェクトは、AnthropicのメモリサーバーをObsidianと統合するように改変したものです。元のサーバーはJSON形式でメモリを保存していましたが、このバージョンではObsidianと互換性のある[[link]]構文を持つ個別のMarkdownファイルとして保存し、グラフの視覚化を可能にしています。

元のサーバーからの主な変更点

• 保存形式：JSONから個別のMarkdownファイルに変更
• Obsidianとの統合：関係性を表す[[link]]構文を追加
• YAMLヘッダー：メタデータをJSONではなくヘッダーに保存
• ファイル構造：各エンティティが個別の.mdファイルになる
• 削除された機能：Markdownのみの保存に焦点を絞り、機能を簡素化

保存形式

各エンティティは、以下の要素を持つ個別のMarkdownファイルとして保存されます。

• YAMLヘッダー：メタデータ（entityType、created、updated）
• Obsidian互換の[[links]]：関係性を表す
• 整理されたセクション：観測結果と関係性を記録

エンティティファイルの例（John_Doe.md）：

---
entityType: person
created: 2025-07-10
updated: 2025-07-10
---

# John Doe

## Observations
- Works at Tech Corp
- Expert in TypeScript
- Lives in Tokyo

## Relations
- [[Manager of::Alice Smith]]
- [[Collaborates with::Bob Johnson]]
- [[Located in::Tokyo Office]]

🔧 技術詳細

API

サーバーは以下のツールを公開しています。

• create_entities：新しいエンティティを作成します。
• create_relations：エンティティ間の関係を作成します。
• add_observations：既存のエンティティに観測結果を追加します。
• delete_entities：エンティティと関連データを削除します。
• delete_observations：特定の観測結果を削除します。
• delete_relations：関係を削除します。
• read_graph：知識グラフ全体を取得します。
• search_nodes：クエリでエンティティを検索します。
• open_nodes：名前で特定のエンティティを取得します。

開発

npm run watch  # 変更を監視して再構築します

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

• 元のメモリサーバー：Copyright (c) 2024 Anthropic, PBC
• Obsidian統合の改変：Copyright (c) 2025 YuNaga224