SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI智能体kybase

kybase

Kybase 是一个自托管的持久化记忆知识库，专为 AI 智能体设计：对人类而言是一个可浏览和编辑的 Markdown 笔记应用，对智能体则通过 Streamable HTTP 上的 MCP 协议（支持 OAuth）提供 18 个工具。它让 Claude、Cursor、Windsurf 等支持 MCP 的智能体拥有长期记忆，所有笔记以纯 Markdown 存储在本地，支持全文与语义混合搜索、[[wikilinks]] 双向链接、知识图谱、章节级读写、导出导入 zip、公开只读分享链接等功能。默认私密运行，可由用户自行选择嵌入提供商（Ollama、Google 或 OpenAI）。采用 AGPL-3.0 许可，可免费使用、修改和自托管。

访问官网

工具介绍

Kybase 是一个自托管的 AI 智能体持久记忆知识库，核心理念是“人类用 Markdown，智能体用 MCP”。它解决智能体会话结束后遗忘上下文的问题，让知识独立于智能体存在，可被多个智能体共享并手动编辑。

主要能力

  • 长期记忆：为 Claude、Cursor、Windsurf 等支持 MCP 的智能体提供跨会话、跨工具的长期记忆。
  • Markdown 知识库：所有笔记均为纯文本 Markdown，可读、可编辑、可 grep、可用 cp 备份。
  • 混合搜索：全文搜索与基于语义的搜索融合为一个排序结果，智能体无论是否知道确切措辞都能找到笔记。
  • 章节级读写：智能体可以只读取或编辑笔记中需要的部分，而不是整个文件。
  • 双向链接与知识图谱：通过 [[wikilinks]] 自动连接相关笔记，形成知识图谱。
  • MCP 工具：通过 Streamable HTTP 在 /api/mcp 提供 18 个 MCP 工具，支持 OAuth 的客户端可浏览器登录获取独立令牌。
  • Web UI：提供浏览器界面、图谱视图、分享链接，支持多个智能体同时连接同一个知识库。
  • 导出与导入：设置中可导出 .zip（纯 Markdown，文件夹作为目录，Obsidian 等编辑器可读），也可导入 .zip 合并回知识库。
  • 公开分享：单条笔记可生成公开只读链接，渲染 Markdown，不登录，wikilinks 显示为纯文本，防止泄露整个库；可在设置中撤销。
  • 备份与升级：所有数据存于一个 Postgres 卷，支持 pg_dump 备份；启动时自动应用迁移。

使用方式

快速开始

  • 仅本地智能体（无需 Docker、数据库）：将相应 MCP 配置放入客户端并重启，笔记存于 ~/.kybase，可用 kybase-mcp export vault.zip 导出为纯 Markdown。
  • 完整功能（Web UI、图谱、分享、多智能体）： macOS/Linux 与 Windows（PowerShell）分别有对应启动命令，会生成所需密钥并启动服务。安装约 1 GB，包含应用与数据库。 启动后打开 http://localhost:3000，用 KYBASE_SECRET 登录（可通过 grep KYBASE_SECRET .env 或 PowerShell 的 Select-String KYBASE_SECRET .env 查看），然后连接智能体。

语义搜索

需要嵌入提供商，在设置中选择：

  • Google 或 OpenAI：粘贴 API 密钥即可。
  • Ollama（本地）：启动一次后在设置中选择模型，命令为 docker compose --profile ollama up -d。因镜像包含 NVIDIA 和 AMD GPU 运行时（约 4 GB），默认不安装。

连接智能体

Kybase 在 /api/mcp 提供 Streamable HTTP 的 MCP 服务。支持 OAuth 的客户端可浏览器登录一次并获得独立令牌（在设置 → Access 中列出并可单独撤销），无需在配置中放 KYBASE_SECRET。

  • Claude Code：添加一次即可用于所有项目，然后运行 /mcp，选择 kybase → Authenticate，在打开的页面输入 KYBASE_SECRET。
  • Claude Desktop 与 claude.ai：自定义 → 连接器 → 添加自定义连接器，填相同 URL，然后连接并登录。实例需可从互联网通过 HTTPS 访问；Claude Desktop 中远程服务器配置不放在 claude_desktop_config.json。
  • Cursor：在 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）中配置，然后在自定义 → MCPs 下连接 kybase 并登录。
  • Windsurf：在 ~/.codeium/windsurf/mcp_config.json 中配置，使用 serverUrl 而非 url。
  • 仅支持 stdio 的客户端：使用快速开始中的 npx -y kybase-mcp 配置。 注意：包含 KYBASE_SECRET 的请求头拥有整个实例的完全访问权，仅用于无 OAuth 的客户端，且应保存在自己的配置中，切勿提交到版本库。

智能体如何使用

  • 搜索会指明匹配的笔记章节，而非仅笔记，节省后续步骤的读取成本，写回时同样适用。
  • 服务器附带指令，教导智能体先搜索再写入，并为相关笔记添加 [[wikilinks]]，使图谱随工作增长而不是充满孤立节点。

适用场景

  • 个人或团队希望让 AI 智能体记住项目决策、环境配置、技术方案等长期上下文。
  • 多智能体（Claude、Cursor、Windsurf 及 Web UI）共享同一知识库。
  • 需要私密、自托管、数据完全自有的知识管理。
  • 希望笔记与智能体记忆合二为一，可手动修正智能体记错的内容。

限制与说明

  • 需要自行部署和维护（Docker 安装约 1 GB，本地 Ollama 约 4 GB）。
  • 默认私密，无 SaaS 账户、无外部记忆服务、无云数据库。
  • 云嵌入提供商为可选项：选择 Google 或 OpenAI 会将笔记全文发送给该提供商以计算嵌入；Ollama 则全部保留在本地。
  • 许可为 AGPL-3.0，可免费使用、修改和自托管；若将修改版作为网络服务运行，必须按同许可向用户提供源码。商业许可（如嵌入闭源产品或服务）需联系作者。
  • 更多文档：SECURITY.md（威胁模型）、CONTRIBUTING.md（本地运行、提交 PR）、docs/backup.md、docs/upgrading.md、packages/kybase-mcp（独立 stdio 包）。

同类工具

查看分类