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 许可证下发布原始实现。