Obsidian Memory MCP

🚀 Obsidian Memory MCP

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

🚀 快速開始

要使用 Obsidian Memory MCP，首先需要進行安裝和配置。

安裝步驟

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

✨ 主要特性

• 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"
      }
    }
  }
}

💻 使用示例

基礎用法

以下是一個實體文件（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]]

高級用法

在開發過程中，可以使用以下命令監聽文件變化並重新構建：

npm run watch  # Watch for changes and rebuild

📚 詳細文檔

關於項目

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

與原始版本的主要區別

• 存儲格式：從 JSON 更改為單獨的 Markdown 文件。
• Obsidian 集成：添加了用於表示關係的 [[鏈接]] 語法。
• YAML 前置元數據：元數據存儲在前置元數據中，而不是 JSON 中。
• 文件結構：每個實體成為一個單獨的 .md 文件。
• 移除的功能：簡化以專注於僅使用 Markdown 存儲。

存儲格式

每個實體都存儲為一個單獨的 Markdown 文件，包含：

• YAML 前置元數據：用於存儲元數據（entityType、created、updated）。
• 與 Obsidian 兼容的 [[鏈接]]：用於表示關係。
• 組織好的部分：用於存儲觀察信息和關係。

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

原始記憶服務器：Copyright (c) 2024 Anthropic, PBC
Obsidian 集成修改：Copyright (c) 2025 YuNaga224

🔧 技術細節

API

服務器提供以下工具：

• create_entities：創建新實體。
• create_relations：在實體之間創建關係。
• add_observations：向現有實體添加觀察信息。
• delete_entities：刪除實體及相關數據。
• delete_observations：移除特定的觀察信息。
• delete_relations：移除關係。
• read_graph：獲取整個知識圖譜。
• search_nodes：通過查詢搜索實體。
• open_nodes：按名稱獲取特定實體。

致謝

本項目基於 Model Context Protocol 服務器集合中的 Anthropic 的記憶服務器。感謝 Anthropic 在 MIT 許可證下發布原始實現。