Obsidian Memory MCP

黑曜石存储器MCP

MCP服务器，将AI内存存储为Markdown文件，以便在Obsidian的图形视图中可视化。

关于

此项目是的修改版本 Anthropic的存储服务器 它已经适应了黑曜石的融合。原始服务器以JSON格式存储内存，而此版本将它们存储为与Obsidian兼容的单独Markdown文件 [[link]] 图形可视化语法。

与原始版本相比的主要变化

• 存储格式：从JSON更改为单个Markdown文件
• 黑曜石融合：已添加 [[link]] 关系语法
• YAML前端编辑器：元数据存储在frontmatter而不是JSON中
• 文件结构：每个实体都成为一个独立的实体 .md 文件
• 已删除功能：简化为只关注Markdown存储

特性

• Markdown存储：个人 .md 每个实体的文件
• 黑曜石融合：用途 [[link]] 图形可视化语法
• 知识图谱：存储实体、关系和观察结果
• 搜索功能：查询所有存储的内存
• YAML前端编辑器：元数据存储在frontmatter中

存储格式

每个实体都存储为一个单独的Markdown文件，其中包含：

• YAML前体 元数据（entityType、已创建、已更新）
• 黑曜石兼容 [[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]]

安装和配置

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. 重新启动克劳德桌面
3. 使用MCP内存工具创建实体和关系
4. 打开Obsidian并查看图表

知识图将通过以下方式可视化：

• 实体文件作为节点
• [[links]] 作为边缘
• 不同实体类型的不同颜色（如果在黑曜石中配置）

API

服务器公开了以下工具：

• create_entities：创建新实体
• create_relations：在实体之间创建关系
• add_observations：向现有实体添加观察结果
• delete_entities：删除实体和相关数据
• delete_observations：删除具体意见
• delete_relations：删除关系
• read_graph：获取整个知识图谱
• search_nodes：按查询搜索实体
• open_nodes：按名称获取特定实体

发展

npm run watch  # Watch for changes and rebuild

鸣谢

该项目基于 Anthropic的存储服务器 来自模型上下文协议服务器集合。我们感谢Anthropic在MIT许可下发布了原始实现。

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

原始存储服务器：版权所有（c）2024 Anthropic，PBC\ 黑曜石集成修改：版权所有（c）2025 YuNaga224