CortexOS Brain MCP 服务器

使用说明（Markdown 格式）

• 项目简介 CortexOS Brain MCP 服务器是一个独立的服务端实现，基于 FastMCP 框架，将大脑路由、舰队状态、任务管理、规则加载、日志记录、知识检索等能力暴露为可被大语言模型调用的工具（Tools），支持通过 MCP 协议进行远程调用和数据交互。

• 主要功能点

  • 读取路由与宪法：read_router，获取大脑的核心协议与动态路由规则。
  • 舰队状态查询：get_fleet_status，返回当前 AI Agent 的任务态势和状态信息。
  • 舰队任务打卡：fleet_claim，登记/更新 Agent 的工作节点与任务描述。
  • 队长移交：fleet_handover，将队长职责移交到指定节点。
  • 按需加载规则：load_rule，懒加载 docs/rules 目录下的规则文件。
  • 列出可用规则：list_rules，返回可用规则清单及数量。
  • 任务日志：log_task，将操作日志写入私有日志，支持证据链注入。
  • 同步看板：fleet_sync，触发看板数据同步以刷新前端展示。
  • 管理密钥：list_secrets 和 read_secret，用于密钥文件的列举与读取。
  • 通知能力：send_lark_notification，通过飞书发送通知。
  • 知识检索：search_knowledge，在外部知识库中进行关键词检索。

• 安装步骤

  1. 准备运行环境：确保已安装 Python（用于运行 MCP 服务器端）及 FastMCP 依赖环境。
  2. 获取代码：将 CortexOS 代码克隆到本地工作目录。
  3. 安装依赖：在服务器端环境中安装所需依赖（如 FastMCP 等）。
  4. 启动服务器：在命令行执行启动命令，使用标准的 MCP 传输方式（见下方“服务器配置”）。
  5. 验证连接：使用 MCP 客户端连接到服务器，调用任意 Tool 以验证响应。

• 服务器配置（MCP 客户端必须提供启动命令与参数以建立连接，以下为准确配置示例描述） server_name: CortexOS Brain MCP Server command: uv args: ["run", "/path/to/CortexOS/mcp_server/server.py"]

  注释：

  • server_name：给该 MCP 服务器取一个易识别的名称，便于在客户端配置中区分。
  • command：启动服务器的可执行程序，这里使用 uv（UV 桶），用于以 MCP 规范运行 Python 服务器脚本。
  • args：启动参数，按顺序包含 "run" 和服务器脚本的实际路径，通知 uv 以该脚本启动 MCP 服务。客户端不需要内部实现细节，只需知道启动命令和参数即可连接。

• 基本使用方法

  1. 启动服务端：使用配置好的启动命令在服务器或开发环境中启动 MCP 服务端（示例：uv run /path/to/CortexOS/mcp_server/server.py）。
  2. 调用工具：通过 MCP 客户端向 CortexOS Brain 发送 JSON-RPC 请求，调用如 read_router、get_fleet_status、fleet_claim 等工具，获取结果或执行操作。
  3. 结果处理：MCP 服务器将返回相应的 JSON-RPC 响应，或发送通知。运行日志及结果可通过 log_task、fleet_sync 等工具进行记录与同步。