Obsidian Memory Mcp

笔记 TypeScript

🚀 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 中使用

按照上述选项之一配置 Claude Desktop。
重启 Claude Desktop。
使用 MCP 记忆工具创建实体和关系。
打开 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 中查看知识图谱的基本步骤：

完成安装与配置。
使用 MCP 记忆工具创建实体和关系。
打开 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 的实现等。

📄 许可证

0 条评论
分类：笔记