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