黑曜石记忆mcp

Name: 黑曜石记忆mcp
Author: YuNaga224

作者：YuNaga22412 星标更新：2025-08-02

安装使用来源：spider==github.com

项目介绍

Obsidian Memory MCP

存储AI记忆为Markdown文件，以便在Obsidian的图视图中进行可视化展示的MCP服务器。

关于

该项目是Anthropic的记忆服务器的一个修改版，已适应与Obsidian集成。原始服务器以JSON格式存储记忆，而此版本则将其存储为单独的Markdown文件，并使用Obsidian兼容的[[link]]语法进行图可视化。

与原始版本的主要变化

存储格式：从JSON改为单独的Markdown文件
Obsidian集成：添加了用于关系的[[link]]语法
YAML前置元数据：元数据存储在前置元数据中，而不是JSON
文件结构：每个实体成为一个独立的.md文件
移除功能：简化为仅专注于Markdown存储

功能

Markdown存储：每个实体为一个独立的.md文件
Obsidian集成：使用[[link]]语法进行图可视化
知识图谱：存储实体、关系和观察
搜索功能：查询所有存储的记忆
YAML前置元数据：元数据存储在前置元数据中

存储格式

每个实体存储为一个独立的Markdown文件，包括：

YAML前置元数据用于元数据（entityType, created, updated）
**Obsidian兼容的[[links]]**用于关系
组织好的部分用于观察和关系

示例实体文件（John_Doe.md）：

---
entityType: person
created: 2025-07-10
updated: 2025-07-10
---

# John Doe

## 观察
- 在Tech Corp工作
- TypeScript专家
- 居住在东京

## 关系
- [[经理为::Alice Smith]]
- [[与::Bob Johnson合作]]
- [[位于::东京办公室]]

安装与配置

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中配置）

API

该服务器暴露了以下工具：

create_entities：创建新实体
create_relations：创建实体之间的关系
add_observations：向现有实体添加观察
delete_entities：删除实体及其相关数据
delete_observations：移除特定观察
delete_relations：移除关系
read_graph：获取整个知识图谱
search_nodes：通过查询搜索实体
open_nodes：通过名称获取特定实体

开发

npm run watch  # 监控更改并重新构建

致谢

本项目基于Anthropic的记忆服务器，来自Model Context Protocol服务器集合。我们感谢Anthropic在MIT许可下发布原始实现。

许可证

MIT许可证 - 查看LICENSE文件以获取详情。