Bridge CLI

allthecodes-bridge-cli

本地 MCP 桥接服务，通过 stdio JSON-RPC 协议统一管理 Projects、Tasks 和 Agents。支持知识库追加、引用验证和原子写入。

Rustrmcpclapserdetokio

数据模型

Projects / Tasks / Agents

三大核心实体，通过引用关系组织

Projects

项目容器，管理项目级别的上下文和配置

id (UUID)namedescriptioncreated_atupdated_at

Tasks

任务管理，包含状态、指令和累积知识

id (UUID)project_id (FK)statusinstructionsknowledge (append-only)

Agents

Agent 管理，支持自定义系统提示词

id (UUID)project_id (FK)namesystem_prompt (max 100KB)

MCP 工具

10 个 MCP Tools

通过 stdio 传输暴露给 MCP 客户端的工具集

project_create创建新项目

project_list列出所有项目

project_get获取项目详情

task_create创建新任务

task_list列出项目下的任务

task_update更新任务状态

task_add_knowledge追加知识条目

agent_create创建新 Agent

agent_list列出 Agent

agent_update更新 Agent 配置

架构

存储与传输

JSON 持久化

状态存储在 $HOME/.allthecodes-bridge-cli/state.json，原子写入（临时文件 + 重命名）

stdio 传输

通过标准输入输出以换行分隔的 JSON-RPC 通信，rmcp 库实现

引用验证

project_id 必须引用已存在的项目，知识库条目只追加不覆盖

使用

快速上手

bash

# 构建
cargo build --release

# 启动 MCP 服务器 (stdio)
allthecodes-bridge-cli serve

# 自定义数据目录
allthecodes-bridge-cli serve --data-dir ~/.allthecodes-bridge-cli

# 健康检查
allthecodes-bridge-cli doctor

# MCP 客户端配置
{
  "mcpServers": {
    "allthecodes-bridge": {
      "command": "allthecodes-bridge-cli",
      "args": ["serve"]
    }
  }
}