← 返回目录

mcp-knowledge-graph

社区

通过本地知识图谱为 AI 模型提供持久记忆。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 数据库第 28 / 58
Stars: ★ 888 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 22+
凭据: 无需凭据
许可证: MIT
最近提交: 4 个月前
工具数: 10

56FMRS · C

该服务器为 AI 记忆管理提供了灵活且安全的设计，支持项目本地和全局存储，并带有多数据库功能。安装简单，但与 Claude API 兼容性需验证。

最强项 · 文档质量 16/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

11/20

维护活跃度

8/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 7/20: 证据：README 描述了十个工具、存储优先级模型、'_aim' 文件标记流程以及带具体错误信息的故障排查章节，设计内部一致。扣分：服务器 manifest 未缓存，且未提供任何源码、已提交测试或 CI 工作流，因此 MCP 初始化/工具列表握手和真实工具行为完全无法核实。静态校准规定缺乏执行证据时可靠性上限为 12，不确定性进一步压低分数。
安全与权限 11/20: 无红线问题：不存在凭据处理、网络外传、示例中的真实令牌或破坏性默认行为。README 披露了数据边界——写入仅限项目 '.aim' 目录或用户配置的 '--memory-path' 目录——并描述了拒绝覆盖无关 JSONL 文件的 '_aim' 安全标记。扣分：标记强制逻辑无法在源码中核实；'forget'/'remove' 等操作除 MCP 客户端自身审批外未描述额外确认流程；项目自动检测可能让用户对写入位置产生意外。最小权限设计看似合理但未经验证。
维护活跃度 8/20: 可用事实：MIT 许可证、仓库未归档、开放 issue 仅 1 个、描述为面向本地开发的 fork。扣分：所供材料中没有提交历史、发布标签、依赖更新记录、issue 响应证据或安全响应渠道；server manifest 未缓存。Star 数仅作为发现信号，不计分。持续维护状态无法确认。
文档质量 16/20: README 分层清晰：全局与项目本地两种快速开始、两份可直接复制的客户端配置、含 'context'/'location' 参数的完整工具列表、对 '.aim' 与 '_aim' 区别的明确解释、文件组织结构图、数据库发现、autoapprove 建议、故障排查、环境要求与许可证。限制与失败模式均有披露。扣分：没有专门的认证/安全说明（本地文件服务器本无需认证，但未言明）、没有明确的规模与成本限制，且文档所述行为缺乏源码佐证。
安装易用性 14/20: 安装路径清晰简短：运行 'npx -y mcp-knowledge-graph' 并可选 '--memory-path'，将两份现成 JSON 配置之一粘贴到 Claude Desktop/.claude.json，或创建 '.aim' 目录进入项目本地模式；并注明需要 Node.js 22+。扣分：静态校准规定在无 CI 工作流或已提交测试验证安装路径时 setup 上限为 15，且 npx 包发布状态与运行时行为无法从现有材料确认。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

需要跨对话记忆的 Claude 用户
希望在本地项目中使用持久记忆的开发者
对数据安全敏感，希望记忆文件存储在本地而非云端的用户

不适合谁

需要分布式或高并发存储的场景
需要内置加密或访问控制的高级安全需求
希望记忆文件存储在云端并由服务商管理的用户

所需权限

读取和写入本地文件系统（在指定 --memory-path 或项目 .aim 目录下）
运行 npx 命令以启动服务器

风险与副作用

本地文件可能被误删或覆盖（系统提供 _aim 标记保护，但风险依然存在）
敏感信息存储在本地，若未加密可能泄露
依赖 Node.js 版本和 npm 包管理，可能出现依赖冲突

安装接入

准备工作

运行环境：Node.js 22+

前置要求：Node.js 22+。初始化：在 Claude 客户端配置文件中添加 MCP 服务器配置，指定本地路径（如 --memory-path），然后启动客户端即可自动安装并运行。

claude_desktop_config.json

{
  "mcpServers": {
    "Aim-Memory-Bank": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-knowledge-graph",
        "--memory-path",
        "/Users/yourusername/.aim"
      ],
      "autoapprove": [
        "aim_memory_search",
        "aim_memory_get",
        "aim_memory_read_all",
        "aim_memory_list_stores"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "Aim-Memory-Bank": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-knowledge-graph",
        "--memory-path",
        "/Users/yourusername/.aim"
      ],
      "autoapprove": [
        "aim_memory_search",
        "aim_memory_get",
        "aim_memory_read_all",
        "aim_memory_list_stores"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add Aim-Memory-Bank -- npx -y mcp-knowledge-graph --memory-path /Users/yourusername/.aim

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端的工具列表中应能看到 aim_memory_store、aim_memory_search 等以 aim_ 为前缀的工具；调用 aim_memory_list_stores 能返回 default 主数据库即说明连接成功。

常见排障

如果出现 'File does not contain required _aim safety marker' 错误，请确保文件以正确标记开头或删除文件让系统重建。
如果记忆存储位置不符合预期，请检查当前目录是否有 .aim 文件夹，并使用 aim_memory_list_stores 查看当前存储位置。
如果数据库文件过多，可以手动删除不需要的 .jsonl 文件，并鼓励 AI 使用一致的命名。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

把“John_Doe 是我在会议上认识的人”存入记忆库
在 work 数据库里搜索关于 Q4 项目的记忆
列出当前所有可用的记忆数据库
删除 personal 数据库中关于旧项目的记忆

工具能力 10

aim_memory_store 写入

存储新的记忆（人、项目、概念）到知识图谱中。

aim_memory_add_facts 写入

向现有记忆中添加事实。

aim_memory_link 写入

在两个记忆之间建立链接。

aim_memory_search 只读

按关键词搜索记忆。

aim_memory_get 只读

按精确名称检索特定记忆。

aim_memory_read_all 只读

读取数据库中的所有记忆。

aim_memory_list_stores 只读

列出所有可用的数据库。

aim_memory_forget 破坏性

删除记忆。

展开其余 2 个工具

aim_memory_remove_facts 破坏性

从记忆中移除特定事实。

aim_memory_unlink 破坏性

移除记忆之间的链接。

使用场景

个人记忆管理：让 AI 助手记住你的偏好、生日、项目信息等。

项目本地记忆：在项目目录中创建 .aim 文件夹，使 AI 自动使用项目级记忆。

跨设备同步：使用 Dropbox 等云同步目录存储记忆文件，实现多设备访问。

支持客户端

Claude Desktop

Claude Code

依据项目文档列出，未经本站实测。

详细介绍

mcp-knowledge-graph 是一个 MCP 服务器，使 AI 模型（如 Claude）能够在对话之间存储和检索信息。它使用实体、关系和观察构建知识图谱，并支持多个数据库（主数据库和命名数据库）以及项目本地或全局存储。该服务器强调安全，通过文件标记 (_aim) 防止意外覆盖无关文件。它专为本地开发设计，适合希望 AI 助手记住长期信息的用户。