内容
# 库姆库姆
> 适用于团队的开源内存基础设施。
> 将分散的公司知识转化为 AI 就绪的上下文。
## 介绍视频
[](http://www.youtube.com/watch?v=DnNchFuE1Do)
停止重置循环。为您的团队提供可检查、可控制和可重用的 AI 工具的可靠内存。
库姆库姆是适用于 AI 原生团队和 MCP 兼容工具的开源内存层。在一个地方存储笔记、记忆、URL 和关系，然后让助手跨会话、项目和客户端检索正确的上下文。
[官网](https://kumbukum.com) · [云端](https://app.kumbukum.com) · [文档](https://docs.kumbukum.com) · [自托管指南](https://docs.kumbukum.com/selfhosted/) · [MCP 文档](https://docs.kumbukum.com/mcp/) · [API 参考](https://docs.kumbukum.com/api/)
## 为什么选择库姆库姆？
AI 工具擅长推理，但不擅长记忆。
库姆库姆为您提供一个共享、可搜索、可编辑的内存层，位于您的团队和 AI 工具之间：
- **持久上下文** — 跨会话保留首选项、决策、文档和书签
- **适用于多种工具** — 将相同的内存存储与 Claude Desktop、Cursor 和其他 MCP 客户端一起使用
- **开放和可检查** — 您的内存不会被困在黑盒中
- **为团队而建** — 按项目组织知识，连接相关项目，并使其可重用
## 包含的功能
- **笔记** — 具有全文和语义搜索的富文本文档
- **记忆** — 用于首选项、决策和学习的短形式上下文
- **URL** — 保存的页面，带有提取的内容和可选的完整站点爬取
- **知识图谱** — 项目之间的手动、基于标签和语义链接
- **AI 聊天** — 使用自然语言搜索和管理知识
- **MCP 服务器** — 44 种工具，用于笔记、记忆、URL、项目、图谱和搜索
- **浏览器扩展** — 从任何地方保存笔记和 URL
- **双向 Git 同步** — 将项目知识同步到 Git 仓库和从 Git 仓库同步
## 工作原理
1. **捕获知识** — 添加笔记、存储记忆、保存 URL 或导入文档
2. **连接您的工具** — 将库姆库姆连接到 Claude Desktop、Cursor 或另一个 MCP 客户端
3. **检索正确的上下文** — 您的助手搜索并重用重要的内容，而不是每次都从零开始
## 云端或自托管
库姆库姆云端和自托管版本共享相同的产品功能。区别在于谁运行基础设施。
| | 云端 | 自托管 |
| --- | --- | --- |
| 功能 | 所有功能 | 所有功能 |
| 托管 | 由我们管理 | 您管理 |
| 更新 | 自动更新 | 手动更新 |
| 备份 | 包含备份 | 您配置备份 |
| 定价 | 订阅制 | 免费（开源） |
## 快速入门
### 库姆库姆云端
1. 在 [app.kumbukum.com](https://app.kumbukum.com) 注册
2. 创建您的第一个项目
3. 在 **设置 →令牌** 中生成个人访问令牌
4. 将库姆库姆添加到您的 AI 工具中
示例：macOS 上的 Claude Desktop 配置：
```json
{
"mcpServers": {
"kumbukum": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.kumbukum.com/mcp"],
"env": {
"ACCESS-TOKEN": "您的访问令牌"
}
}
}
}
```
### 自托管
#### 使用 Docker Compose 进行生产部署
要求：
- Node.js >= 24
- Docker & Docker Compose
- pnpm 10+（用于本地开发）
- MongoDB 6+
- Redis 6+
- Typesense 31+
获取生产 Compose 文件，并将配置作为 shell 环境变量传递：
```bash
curl -O https://raw.githubusercontent.com/kumbukum/kumbukum/main/compose.prod.yml
APP_URL=https://您的实例.com \
SESSION_SECRET=您的会话密钥 \
JWT_SECRET=您的 JWT 密钥 \
TYPESENSE_API_KEY=您的 Typesense 密钥 \
SMTP_HOST=smtp.example.com \
SMTP_USER=您@example.com \
SMTP_PASS=您的 SMTP 密码 \
SMTP_FROM=noreply@example.com \
GOOGLE_API_KEY=您的 Google API 密钥 \
docker compose -f compose.prod.yml up -d
```
对于多个出站 SMTP 服务器，请将 `SMTP_SERVERS` 设置为服务器对象的 JSON 数组。库姆库姆通过它们进行轮询。
示例：
```bash
SMTP_SERVERS='[
{
"name": "smtp-1",
"host": "smtp1.example.com",
"port": 587,
"secure": false,
"user": "smtp-user-1",
"pass": "smtp-pass-1",
"from": "server@kumbukum.com"
},
{
"name": "smtp-2",
"host": "smtp2.example.com",
"port": 465,
"secure": true,
"user": "smtp-user-2",
"pass": "smtp-pass-2",
"from": "server@kumbukum.com"
}
]'
```
在 Docker Compose YAML 中，将其引用为单个 JSON 字符串：
```yaml
environment:
SMTP_FROM: server@kumbukum.com
SMTP_SERVERS: >-
[{"name":"smtp-1","host":"smtp1.example.com","port":587,"secure":false,"user":"smtp-user-1","pass":"smtp-pass-1","from":"server@kumbukum.com"},{"name":"smtp-2","host":"smtp2.example.com","port":465,"secure":true,"user":"smtp-user-2","pass":"smtp-pass-2","from":"server@kumbukum.com"}]
```
仅 `host` 是每个服务器必填的。`port` 默认值为 `587`，`secure` 仅在端口 `465` 时默认为 `true`，而 `from` 则默认为 `SMTP_FROM`。
不需要 `.env` 文件。
默认服务端口：
| 服务 | 端口 |
| --- | --- |
| 应用 | `3000` |
| WebSocket | `3001` |
| MCP 服务器 | `3002` |
| MongoDB | `27017` |
| Redis | `6379` |
| Typesense | `8108` |
### 本地开发
对于仓库开发，请确保 MongoDB、Redis 和 Typesense 可用，然后运行：
```bash
git clone https://github.com/kumbukum/kumbukum.git
cd kumbukum
pnpm install
pnpm dev
```
有用脚本：
- `pnpm dev` — 运行应用程序并自动重新加载
- `pnpm build` — 构建前端资产
- `pnpm test` — 运行测试套件
- `pnpm test:mcp` — 运行 MCP 特定测试
- `pnpm docs:dev` — 在本地运行文档站点
## MCP 服务器
库姆库姆包含一个内置的 [Model Context Protocol](https://modelcontextprotocol.io/) 服务器，具有：
- **44 种工具**，涵盖笔记、记忆、URL、项目、图谱、搜索和 AI 聊天
- **工具间的共享内存**，因此 Claude Desktop、Cursor 等客户端从相同的上下文中提取
- **三种传输方式** — stdio、SSE 和 Streamable HTTP
- **基于令牌的身份验证**，通过 `Authorization: Bearer`、`access-token` 或 stdio 环境变量
- **自动默认项目选择**，因此工具无需额外设置即可工作
自托管示例：
```bash
env 'ACCESS-TOKEN'=您的访问令牌 API_BASE_URL=https://您的实例.com node apps/mcp/server.js
```
## 架构概览
- **后端** — Node.js + Express
- **数据库** — MongoDB
- **搜索** — Typesense，用于全文和语义检索
- **缓存/实时** — Redis + Socket.IO
- **前端** — Pug 模板 + 原始 JavaScript
- **MCP 应用** — `apps/mcp/`，用于代理集成
## 文档
- [指南](https://docs.kumbukum.com/guide/)
- [自托管](https://docs.kumbukum.com/selfhosted/)
- [MCP 服务器](https://docs.kumbukum.com/mcp/)
- [API 参考](https://docs.kumbukum.com/api/)
- [云端](https://docs.kumbukum.com/cloud/)
## 许可证
根据 [AGPL-3.0](LICENSE) 许可。
