Obsidian Memory MCP

🚀 Obsidian Memory MCP

AIの記憶をMarkdownファイルとして保存し、Obsidianのグラフビューで可視化するためのMCPサーバーです。

🚀 クイックスタート

このサーバーを使用することで、AIの記憶をObsidianのグラフビューで可視化できます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• Markdown形式での保存：各エンティティを個別の.mdファイルとして保存します。
• Obsidianとの統合：グラフ可視化のために[[リンク]]構文を使用します。
• 知識グラフ：エンティティ、関係、観測結果を保存します。
• 検索機能：保存されたすべての記憶をクエリできます。
• 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"
      }
    }
  }
}

💻 使用例

基本的な使用法

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

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

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

📚 ドキュメント

概要

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

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

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

保存形式

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

• YAMLフロントマター：メタデータ（エンティティタイプ、作成日、更新日）を保存する
• Obsidian互換の[[リンク]]：関係性を表す
• 整理されたセクション：観測結果と関係性を保存する

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

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

# John Doe

## 観測結果
- Tech Corpで勤務
- TypeScriptのエキスパート
- 東京に居住

## 関係性
- [[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