Obsidian Memory MCP

🚀 Obsidian Memory MCP

Obsidian Memory MCP 是一個 MCP 服務器，它將 AI 記憶以 Markdown 文件的形式存儲，以便在 Obsidian 的圖譜視圖中進行可視化展示。

🚀 快速開始

安裝與配置

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 中進行了配置）。

✨ 主要特性

• 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. 完成安裝與配置。
2. 使用 MCP 記憶工具創建實體和關係。
3. 打開 Obsidian，即可在圖譜視圖中查看可視化的知識圖譜。

高級用法

可以使用服務器提供的 API 進行更復雜的操作，例如批量創建實體和關係等。

📚 詳細文檔

關於

本項目是 Anthropic 的記憶服務器 的修改版本，已適配與 Obsidian 集成。原始服務器以 JSON 格式存儲記憶，而此版本將其存儲為單獨的 Markdown 文件，並使用與 Obsidian 兼容的 [[link]] 語法進行圖譜可視化。

與原始版本的主要更改

• 存儲格式：從 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  # 監聽更改並重新構建

🔧 技術細節

本項目基於 Model Context Protocol 服務器集合中的 Anthropic 的記憶服務器 進行修改。主要技術細節包括存儲格式的更改、與 Obsidian 的集成以及 API 的實現等。

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。 原始記憶服務器：版權所有 (c) 2024 Anthropic, PBC Obsidian 集成修改版：版權所有 (c) 2025 YuNaga224