项目简介

Rizom Brains是一个功能丰富的知识管理后端，其核心是实现Model Context Protocol (MCP)。每个“大脑”实例都作为一个MCP服务器运行，通过暴露标准化工具和资源，使AI助手能够高效地管理和利用个人或团队的知识库。它支持多种实体类型、Markdown内容存储、向量搜索、Git同步，并提供强大的插件架构，可以通过CLI、Matrix机器人或直接MCP连接进行交互。

主要功能点

统一实体模型: 存储笔记、任务、个人资料和自定义实体，实现知识的结构化管理。
Markdown优先存储: 所有内容以Markdown格式存储，易于编辑和版本控制。
向量搜索: 利用本地嵌入技术提供语义搜索能力，智能查找相关信息。
Git同步: 将知识库与Git仓库同步，实现版本控制、协作和备份。
插件架构: 高度可扩展，允许开发者添加自定义实体类型、工具和功能。
多接口支持: 提供命令行界面(CLI)、Matrix聊天机器人以及直接的MCP连接方式。
AI集成: 通过MCP工具和资源，AI助手可以直接访问数据、调用功能，实现智能化的知识管理和交互。

安装步骤

克隆仓库: 在您的终端中运行以下命令克隆项目仓库：

git clone https://github.com/rizom-ai/brains.git
cd brains

安装依赖: 确保您已安装 Bun 运行时。然后运行以下命令安装项目依赖：
```
bun install
```
构建项目: 运行构建命令：
```
bun run build
```

运行团队大脑应用: 进入 'apps/team-brain' 目录并启动服务器：

cd apps/team-brain
bun run dev

服务器配置

MCP客户端需要MCP服务器的连接信息才能与其通信。对于Rizom Brains服务器，以下是一个典型的JSON配置结构示例，包含了连接所需的基本信息。请根据您的实际部署环境调整 'cwd' 路径。

{
  "server_name": "Rizom Brains 服务器",
  "command": "bun",
  "args": [
    "run",
    "dev"
  ],
  "cwd": "/path/to/your/brains/apps/team-brain",
  "protocol": "stdio",
  "description": "连接到Brains MCP服务器，使用stdio协议进行通信。",
  "notes": "请将 'cwd' 替换为您的Brains项目 'apps/team-brain' 目录的实际路径。'args' 中的 'dev' 命令会启动开发模式的服务器。"
}

基本使用方法

在服务器运行后（例如通过 'bun run dev' 命令），您可以在另一个终端通过Brains提供的CLI客户端进行交互：

启动CLI客户端: 在 'apps/team-brain' 目录下运行 'bun run dev --cli'。
创建笔记: 尝试输入 'create note "我的第一篇笔记" --content "这是一篇关于重要想法的笔记。"'
搜索知识: 尝试输入 'search "重要想法"'
查看状态: 尝试输入 'status' 来查看大脑的运行信息和插件状态。
与AI交互: 如果配置了AI服务，可以直接通过CLI或MCP客户端调用大脑的AI工具进行问答或内容生成。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息