Boucle Broca MCP 服务器

关键词

内存服务JSON-RPC资源共享脚本工具Broca

使用说明

  • 项目简介
    • Boucle 是一个面向自我学习与自我改进的 AI 代理循环框架。该仓库内的 MCP 服务器实现将 Broca 的内存等能力通过 MCP 协议暴露，供 LLM 客户端（如 Claude Desktop/Code 等）以标准化方式访问资源、执行工具和获取信息。
  • 主要功能点
    • MCP 核心能力暴露：实现 initialize、tools/list、tools/call 等 MCP 请求的处理与响应，遵循 JSON-RPC 结构进行通信。
    • 以 Broca 内存为基础的资源提供与工具执行能力：可对内存进行读取、搜索、记忆、记事等操作，供外部代理访问。
    • 以 stdio 传输为主的 MCP 服务器实现：提供简单直接的本地集成方式，便于快速测试与本地多进程协作。
    • 与 Boucle 生态其他模块的集成：可与 Broca、搜索、关系图等构件协同工作，为多代理协作提供上下文服务。
  • 安装步骤
    • 先安装 Rust 环境并获取源码（如已克隆仓库）：使用 cargo 构建发布版本。
    • 构建并运行 MCP 服务器（以 stdio 传输为例）：
      • cargo build --release
      • 在代理根目录下执行：boucle mcp --stdio
  • 服务器配置（供 MCP 客户端参考，客户端通常需要配置 JSON 类参数）
    • 服务器名称: Boucle Broca MCP Server
    • 启动命令: boucle
    • 启动参数: ["mcp", "--stdio"]
    • 说明: 该 MCP 服务器当前实现主要通过标准输入输出（stdio）与客户端通信，提供 initialize、tools/list、tools/call 等方法的 JSON-RPC 交互能力。若未来扩展其他传输（如 HTTP/SSE/WebSocket），需要在实现中增加对应传输实现并保持协议兼容。
    • JSON 配置示例（仅供理解，MCP 客户端不需要你来实现）: { "serverName": "Boucle Broca MCP Server", "command": "./boucle", "args": ["mcp", "--stdio"], "transport": "stdio", "mcpVersion": "2025-11-25", "notes": "当前实现仅支持 stdio 传输，未来可扩展为 HTTP/WS/SSE。" }
  • 基本使用方法
    • 启动后客户端可以通过 MCP 协议发送 JSON-RPC 请求，主要包括：
      • initialize：服务器初始化信息，包含协议版本、能力、服务器信息等。
      • tools/list：列出服务器支持的工具及输入参数结构。
      • tools/call：调用具体工具，传入名称及参数，获取执行结果。
    • 客户端与服务器的通信遵循 JSON-RPC 2.0 规范，服务器按行读取 JSON-RPC 请求并返回同样结构的 JSON-RPC 响应。
    • 如遇到网络/进程管理等问题，请参考 Boucle 官方文档中的 MCP 相关说明进行排错。

服务器信息

访问项目