Knownbase MCP Server

通过 Model Context Protocol 为 AI 代理提供持久、可搜索的项目记忆。

Knownbase 是一个托管的 MCP 服务器，为 AI 编码代理（Claude、Cursor、ChatGPT、Claude Code、Windsurf 以及任何其他兼容 MCP 的客户端）提供一个读写持久笔记、决策和交接的地方，这些内容存在于你的 git 历史之外：代理在会话结束那一刻就会丢失的工作记忆。

本仓库记录了 /mcp 端点：如何连接、它暴露了哪些工具，以及身份验证如何工作。无需本地安装：Knownbase 是一个远程的、可流式 HTTP 的 MCP 服务器，因此连接只需将你的客户端指向一个 URL。

https://knownbase.dev/mcp

它解决的问题

AI 代理在会话之间是无状态的。每一次新的聊天、每一个新的终端、每一个重启的 IDE 窗口都从零开始。代理会重新阅读你的代码，但对事物为何如此没有记忆：

• 架构决策及其背后的权衡

• 调试轨迹（“我们尝试了 X，但因为 Y 没有成功”）

• 代码本身不明显的约定和陷阱

• 会话之间的任务交接，或你与队友的代理之间的交接

• 任何你不想让 git 历史变得杂乱但仍需要代理知道的内容

没有记忆层，你最终会在每个会话中重新解释相同的上下文，或者代理会两次重新发现（并重新破坏）同一件事。Knownbase 为代理提供了一个可以直接搜索和写入的工作区，这样记忆就会持续并累积，而不是重置。

Related MCP server: Librarian

快速开始

1. 在 knownbase.dev 创建一个免费工作区（无需信用卡）。

2. 将你的 MCP 客户端连接到 https://knownbase.dev/mcp；有关每个客户端（Claude、Claude Code、ChatGPT、Cursor 和通用 MCP 客户端）的具体步骤，请参阅 docs/CONNECTING_CLIENTS.md。

3. 使用静态 API 密钥或 OAuth 2.1 进行身份验证（大多数客户端会自动发现 OAuth）；请参阅 docs/AUTHENTICATION.md。

4. 使用 get_context 开始任务以加载已知内容，使用 remember 写入持久知识，并回退到 search_notes / get_note / upsert_note 进行直接控制。完整工具参考：docs/TOOLS.md。

它暴露了什么

笔记还带有可选的类型化、时间性元数据（decision / fact / constraint / …，以及 current / superseded / disputed 生命周期），get_context 会据此进行排序和过滤。请参阅工具参考中的 类型化、时间性记忆。

完整的参数级参考，包括为节省代理 token 而设计的默认精简响应格式，请参阅 docs/TOOLS.md。

为什么选择远程托管的 MCP 服务器

每条笔记都限定在你自己的工作区中；不会跨租户共享任何内容。全文搜索（以及在支持的套餐中，基于语义/含义的搜索）在服务器端运行，因此代理无需将整个笔记语料库加载到上下文中即可获得结果。笔记有版本控制（每次编辑都会生成一个修订快照）并支持软删除（进入回收站，而非永久删除），因此代理的写入永远不会是单向门。

链接

• 主页：Knownbase 是什么以及适合谁

• 功能

• 定价：免费层（3 个项目、300 条笔记、2 个 MCP 密钥），以及 Go / Solo / Team / Business 计划，每个都有 7 天免费试用

• 博客：关于 MCP、代理记忆和交接的指南

• llms.txt：机器可读的产品/端点摘要

• 联系 · hello@knownbase.dev

仓库内容

• docs/AUTHENTICATION.md：API 密钥、OAuth 2.1 流程、项目范围密钥

• docs/CONNECTING_CLIENTS.md：每个客户端的设置（Claude、Claude Code、ChatGPT、Cursor 等）

• docs/TOOLS.md：完整的工具参考，包含输入/输出格式

• server.json：MCP Registry 清单

本仓库记录的是一个托管服务；它不包含 Knownbase 服务器的源代码。发现这些文档有问题，或与实际服务器行为不符？请提交 issue 或发送电子邮件至 hello@knownbase.dev。

许可证

本仓库中的文档采用 MIT 许可证。Knownbase 服务本身的使用受其服务条款约束。