Cyberbrain MCP 服务器

关键词

知识库本地笔记高级 recall采访与提取自动化知识管理

使用说明（Markdown 格式）

  • 项目简介

    • Cyberbrain MCP 服务器是一套基于 MCP 的后端服务，用于向 MCP 客户端提供对知识库资源（备忘、笔记等）、工具执行（如从会话 transcript 提取知识点、将文本文件写入 vault、从 vault 检索相关笔记）以及提示模板的统一访问与渲染能力。服务器通过 JSON-RPC 与前端/客户端通信，并在 Claude Desktop 等环境中注册为一个可用的 MCP 服务。

  • 主要功能点

    • 提供三个核心工具：cb_extract（从 transcripts 提取 beats 并写入 Vault）、cb_file（将文本 filing 到 vault）、cb_recall（在 vault 中回溯检索相关笔记）。
    • 支持通过 FastMCP 提供 MCP 服务入口，配套工具（cb_read、cb_status 等）用于查询和状态展示。
    • 与 extract_beats、后台搜索索引等模块紧密集成，支持项目级路由、自动归档、日记等增强特性。
    • 包含行为提示、会话启动时的 orient/ recall 提示模板，以及用于在 Claude Desktop 中自动化触发的配置。
    • 通过 mcp 资源、提示、工具等机制实现与 MCP 客户端的规范化交互。

  • 安装与运行（简要要点）

    • 使用仓库提供的安装脚本或 README 指引将 MCP 服务器安装到本地环境，例如将服务器程序放置在 ~/.claude/cyberbrain/mcp/server.py，并在 Claude Desktop 的配置中注册该 MCP 服务器。
    • 服务器启动通常通过运行服务器脚本并保持进程在前台/后台运行，Claude Desktop 将通过配置与之通信。
    • 客户端需要的最小配置是指向 MCP 服务器的启动命令和参数，以便建立通信。

  • 服务器配置（MCP 客户端所需JSON 配置示例） 说明：下面的字段用于 MCP 客户端在启动连接时读取，用于建立与服务器的通信。实际路径与参数请根据本地环境替换为真实值。

    • server_name: cyberbrain
    • command: "/path/to/python" // 运行服务器脚本的解释器路径
    • args: ["/path/to/mcp/server.py"] // 服务器脚本路径，作为参数传给解释器 注释：
    • server_name 用于在客户端 UI 中标识该 MCP 服务。
    • command/args 指向实际的执行命令与服务器脚本位置，需与你的环境相匹配。
    • 由于客户端通常以 MCP 配置形式读取，该配置本身不包含 Vault 具体路径等敏感信息，路径等需在服务器端自行解析配置文件获得。

  • 基本使用

    • 启动：确保服务器脚本可执行并在环境中可访问，客户端配置正确后，Claude Desktop 等 MCP 客户端即可连接并调用 cb_extract、cb_file、cb_recall 等工具。
    • 使用场景：在对话中直接通过 MCP 工具调用来提取知识、 filing 重要信息、检索 vault 中的相关笔记等。
    • 退出与维护：如需停止服务，正常结束服务器进程即可，客户端可在 UI 中断开连接。

服务器信息

访问项目