knowmind

knowmind

**为 AI 工具提供持久记忆。**只需存储一次，即可在 Claude Code、Cursor 以及任何运行本地（stdio）服务的其他 MCP 客户端中使用；每条事实都会以带有来源、置信度和双时态历史的类型化知识图谱形式保存。服务托管于德国（Hetzner，纽伦堡数据中心）；本仓库中的 CLI 和 MCP 服务采用 Apache-2.0 许可。

**免费套餐永久免费，且无需提供付款信息。**所有套餐均包含 API、CLI 和 MCP 服务。

· knowmind.de

三步连接你的 AI 工具

1. 在 knowmind.de 创建免费账户并生成访问令牌：Dashboard → API tokens。
2. 在本地存储令牌：

npx -y knowmind login --token kmt_xxxxxxxx

3. 配置客户端：

Claude Code（一条命令）

claude mcp add knowmind --env KNOWMIND_TOKEN=kmt_xxx -- npx -y knowmind mcp

Cursor（~/.cursor/mcp.json）——同一个 mcpServers 配置块也适用于 Claude Desktop、Windsurf 和 Gemini CLI 的配置文件；Zed 要求将其放在 context_servers 下：

{
  "mcpServers": {
    "knowmind": {
      "command": "npx",
      "args": ["-y", "knowmind", "mcp"],
      "env": { "KNOWMIND_TOKEN": "kmt_xxx" }
    }
  }
}

任何其他 MCP 客户端：knowmind 是通过 stdio 运行的标准 MCP 服务（npx -y knowmind mcp）。在 Windows 上，使用 npx -y knowmind install <ide> 效果更好：如果 Python 3.10 至 3.14 的 pythonw.exe 位于默认位置（%LOCALAPPDATA%\Programs\Python\Python3… 或 C:\Python3…），它写入的配置项会在启动服务时不打开控制台窗口；Codex 和打印出的 Claude Code 命令则会直接使用 npx。如果你手动配置时 npx 无法直接启动，请使用 "command": "cmd"、"args": ["/c", "npx", "-y", "knowmind", "mcp"]；没有自带控制台的客户端会在每次调用工具时打开一个窗口。

npx -y knowmind install <ide> 会为你写入此配置，例如 cursor、vscode、windsurf、zed、claude-desktop、gemini 或 codex；npx -y knowmind install list 会显示所有客户端。对于 Claude Code，它会改为打印 claude mcp add 命令；--project 会在当前文件夹中写入 .mcp.json。

无法从环境变量读取令牌的客户端会获得一个占位符，需要将其替换为你的令牌。再次运行 install 只会更新 knowmind 配置项，并保留你已输入的令牌；修改文件前，它会在同一目录中保存一份副本。

npx -y knowmind init 会在客户端中设置记忆管理机制：在 Claude Code 中添加钩子，在每个任务开始前回忆记忆；如果某个回合中出现值得保留的内容（部署或提交、新规则、架构决策、代码或配置变更），且尚未存储任何内容，就会在该回合结束前提示模型进行存储；此外，还会在 Cursor 中添加规则文件，并在 AGENTS.md 中添加一段内容，告知 Codex 何时应询问 knowmind 以及需要保留什么。

knowmind 如何存储事实

• **双时态历史。**每条事实都带有两个时间轴：事实有效的时间，以及事实被记录的时间。更正不会覆盖原始内容；旧陈述仍可查询，并标明其失效日期，因此你可以还原系统在任意一天所掌握的信息。
• **每条事实均有来源和置信度。**新事实必须注明置信度，并保留其来源链接。没有置信度的旧事实会被标记为缺少置信度。
• **类型化知识图谱。**实体和关系使用一组受限的边类型；写入时会拒绝兜底式关系。
• **在欧盟运营，按租户隔离。**服务运行于德国纽伦堡的 Hetzner，提供租户隔离、公开的数据处理协议，以及位于 knowmind.de/legal/avv 的子处理方名单。访问日志采用哈希链，并通过外部时间戳服务加盖时间戳（RFC 3161）。

knowmind 是一项托管服务；没有面向社区的可自托管版本。如果你需要自托管，下面列出的项目会更适合你。knowmind 专为需要在欧盟使用带审计记录的托管记忆服务的个人和团队打造。

定价

套餐	价格	适用对象
Free	€0	个人用户和评估用途
Pro	€15/month or €150/year	个人专业人士
Team	€99/month	需要共享记忆的团队
Business	€349/month	较大的团队
Enterprise	from €1,000/month	有本地部署要求的组织

免费套餐包含 2,500 条记忆、1 位用户和 30 天的访问日志。

价格对比（供应商定价页面，核查日期：2026-09-05）：

产品	免费套餐	首个付费套餐	可自托管
knowmind	2,500 条记忆	€15/month	否（Enterprise 提供本地部署选项）
Mem0	10,000 条记录，每月 1,000 次检索	$19/month	是（Apache-2.0）
Zep	每月 10,000 个积分	$125/month	Graphiti 开源；Zep 提供 BYOC
cognee	1M 个令牌，1 个工作区	每 1M 个令牌 $2.50	是
Letta	受限 Agent，使用自有密钥	$20/month	是（据供应商说明）
Supermemory	约 $5 的用量额度	$19/month	从 Scale 套餐起

详情和当前价格：knowmind.de/pricing。

命令

npx -y knowmind search "Where does the staging deploy run?"
npx -y knowmind upload notes.md --title "Meeting notes 2026-05-12"
npx -y knowmind stats
npx -y knowmind health
npx -y knowmind status --line   # one-line status for your AI tool's statusline
npx -y knowmind sync ./openwiki  # pages in Open Knowledge Format keep their review data

Open Knowledge Format 中的知识

knowmind sync 会读取 Open Knowledge Format（OKF 0.1 和 0.2）中的文件夹， 例如 OpenWiki 在仓库中创建的 openwiki/ 文件夹。

之后，每条搜索结果都会包含页面的 status（如果页面未设置，则为 stable）、 OKF 定义的信任等级（trust：unverified、 machine-confirmed 或 human-reviewed），以及页面列出的来源数量。如果 页面提供了相关信息，搜索结果还会包含页面的生成者或生成方式 （generated）、最近五次验证记录（verified）、页面被视为过时的时间 （stale_after），以及前十个来源（sources）。完整的标头仍是文档的一部分。

在知识包中，目录索引（index.md）和日志（log.md）不会被 导入。knowmind 会根据根目录 index.md 中的 okf_version，或 OpenWiki 在该目录中保留的文件来识别知识包。如果两者都未找到，--okf 会将你 同步的文件夹视为知识包。

可用工具

通过 MCP 提供 15 种工具。每种工具都针对你自己的工作区运行；服务 绝不会看到其他租户的数据。

阅读

knowmind_recall_memories — 搜索记忆并获取回答问题的段落，按相关性排序。结合关键词搜索、向量相似度和知识图谱，然后使用交叉编码器重新排序。 query（字符串，必填）· k（整数，默认值 5，最大值 20）· hops（整数，默认值 2——从命中项开始沿图边追溯的距离） 用法： AI 工具在回答前询问“计费服务使用的是哪个数据库？”，而不是猜测。 错误： 没有匹配项时返回空结果集，不会编造答案。

knowmind_recall_at_time — 使用相同的搜索，但查询指定日期时的记忆状态。排除在该日期之后被取代的事实；返回当时有效的事实，即使它们现在已不再成立。 query（字符串，必填）· as_of（ISO 日期或时间戳，实际使用时必填）· k（整数，默认值 5） 用法：“我们 3 月份的定价是多少？”——根据当日的状态回答，而不是根据今天的状态。 与 knowmind_recall_memories 的区别： 查询当前情况时使用 recall，查询过去情况时使用 recall_at_time。使用 recall 查询过去时，返回的是今天的事实。

knowmind_list_recent — 最近添加的条目，按时间从新到旧排列。 k（整数，默认值 10） *用法：*快速查看本次会话期间写入记忆的内容。

knowmind_list_relations — 与某个条目关联的所有类型化边，包含两个方向。 memory_id（字符串，必填） *用法：*在修改或取代某份合同前，询问“这份合同关联了什么？”。 *错误：*未知 ID 会返回错误，而不是空列表。

knowmind_get_schema — 此工作区接受的实体类别和关系类型。无参数。 *用法：*调用 knowmind_upsert_entity 或 knowmind_link_entities 前先调用此工具，以使用服务接受的类型，而不是自行编造类型。

knowmind_list_inferred — 等待人工决策的关系：knowmind 从文本中推断出的关系，以及起始条目来自文档、但其类型需要为人物、组织或类似对象的关系。每项都附带审核状态、两个关联条目、来源以及提供支持的条目。 status（open、confirmed 或 rejected，可选）· limit（整数，默认值 50，最大值 200）· offset（整数，默认值 0） *用法：*审核图谱自行学习到的内容。在有人确认前，未处理的关系不会参与推导规则。

knowmind_get_stats — 语料库规模：文档、分块、实体、边。 无参数。

knowmind_get_health — 检查服务及其存储是否可访问。无参数。 *用法：*显示状态，或在进行长时间摄取前执行检查。

写入

knowmind_store_memory — 存储一条简短的事实、决定或备注。内容会作为一个 整体保存，不会拆分。 content（字符串，必填） · title（字符串） · memory_type（字符串，例如 semantic、episodic） · tags（字符串数组） · source（字符串） · domain（字符串） · relations（数组 — 与条目一并创建的边） 用法： 会议后记录“我们决定将单体架构保留到第三季度”。 错误： 如果文本中包含疑似密码或访问密钥的内容，将以 422 拒绝。请改为存储指向该机密的引用，而非机密本身。

knowmind_upload_document — 将较长的文本作为文档存储。文本会拆分为段落、生成嵌入，并可通过 knowmind_recall_memories 搜索。 content（字符串，必填） · title（字符串） · source（字符串） · relations（数组） 用法： 会议纪要、规范或手册章节。 与 knowmind_store_memory 的区别： 想要逐字取回的一句话属于记忆；想要通过搜索查找的一页内容属于文档。较长的文本若作为记忆存储，会作为一个整体检索，从而挤占其他结果。

knowmind_update_fact — 替换已变更的事实。旧版本会保留其有效期范围，并且可供审计；不会删除任何内容。 target_id（字符串，必填） · new_title（字符串，必填） · new_content （字符串，必填） · update_reason（字符串） 用法： 价格、截止日期或职责发生变更。切勿覆盖，而应替换，这样仍可回答“我们在七月时相信什么”。 错误： 未知的 target_id 会被拒绝。

knowmind_upsert_entity — 创建或更新带有别名的类型化实体（例如个人、公司或 产品）。 name（字符串，必填） · entity_class（字符串，必填 — 参见 knowmind_get_schema） · description（字符串） · aliases（字符串数组） 用法： 为“ACME Ltd.”添加别名，以便有关“ACME”的问题能找到它。 错误： 不属于架构的类别会被拒绝。

knowmind_link_entities — 在两个条目之间创建带置信度值的类型化边。 from_id（字符串，必填） · to_id（字符串，必填） · rel_type（字符串， 必填 — 参见 knowmind_get_schema） · confidence（数字，范围为 0–1） 用法： 将合同与其所属的客户关联起来。系统会为你创建反向边。

knowmind_unlink_entities — 移除类型化边。 from_id、to_id、rel_type（均为必填） 用法： 移除误建的边。条目本身会保留。

knowmind_review_inferred — 记录对 knowmind_list_inferred 中某个关系的决定。confirm 会使其参与推导规则；reject 会结束该关系、其反向关系以及由其推导出的所有关系（会设置 valid_to，但不会删除任何内容）；undo 会撤销拒绝决定。 edge_id（字符串，必填） · decision（confirm、reject 或 undo，必填） · evidence（字符串，可选 — 支持该决定的条目 ID） 用法： 查看列表后使用。返回操作前后的状态，以及受影响的反向关系和推导关系数量。

关于删除

没有删除工具，这是有意为之。事实会被替换（knowmind_update_fact），边会被移除（knowmind_unlink_entities），历史记录则始终可供审计。删除整个工作区及其数据可通过 Web 界面 knowmind.de 自行操作 — Agent 不应能够通过调用工具来执行此操作。

旧工具名称

2026 年 9 月 12 日，七个工具更名为 knowmind_<verb>_<object> 格式，以明确表示每个工具是读取还是写入。旧名称会继续正常响应，直至 2027 年 3 月 31 日，并仍会出现在发现结果中，但会标记为已弃用：

旧名称	新名称
knowmind_recall	knowmind_recall_memories
knowmind_health	knowmind_get_health
knowmind_stats	knowmind_get_stats
knowmind_schema	knowmind_get_schema
knowmind_entity	knowmind_upsert_entity
knowmind_link	knowmind_link_entities
knowmind_unlink	knowmind_unlink_entities

knowmind_entity 更名为 upsert，而非 get：它会创建节点，或返回现有节点。工具的其他方面均未改变——参数和行为都相同。

发现

GET https://knowmind.de/api/mcp/v1 无需令牌即可返回名称、版本、协议版本以及包含输入架构的完整工具列表。目录爬虫和检查工具可以匿名读取完整信息；只有 tools/call 需要密钥。

链接

文档 · 定价 · 数据处理协议 · 隐私

---

德语版本请参阅 README.de.md。