使用说明（Markdown 格式）

• 项目简介 这是一个实验性 MCP 服务器实现，采用 Bun/Node 环境，提供基于 MCP 的后端服务，能够管理会话、处理来自客户端的请求、注册并执行工具，以及渲染与输出提示文本，目标是为大语言模型客户端提供稳定、可扩展的上下文服务。

• 主要功能点

  • MCP 服务器实现：实现常用的 MCP 请求/响应流程，支持 start_council、join_council、get_current_session_data、send_response、close_council 等核心操作。
  • 会话与状态管理：使用本地文件系统存储会话状态，支持并发访问控制（锁机制）和原子写入，确保数据一致性与持久化。
  • 工具注册与执行：通过 MCP 服务端暴露工具接口，允许客户端调用并得到结构化/文本化的返回内容。
  • 多传输和格式支持：MCP 服务器通过标准的 Socket/stdio 传输，支持 JSON/Markdown 形式的工具输出，便于不同客户端接入。
  • 本地 UI 与 API 层：提供本地聊天 UI（可选）以及一组用于 MCP 客户端的 API、映射和数据转换层，便于前后端解耦。

• 安装步骤

  • 环境需求：需要 Node.js 或 Bun。
  • 安装并启动 MCP 服务器（示例命令来自仓库文档，具体以实际环境为准）： npx agents-council@latest mcp
  • 如需本地聊天界面，按仓库提供的 chat 命令启动聊天界面（默认本地运行）。

• 服务器配置（MCP 客户端需要的配置信息，JSON 结构示例） 说明：下面给出一个符合仓库实现的示例配置，包含服务器名称、启动命令及参数。MCP 客户端在集成时通常需要此信息来连接到 MCP 服务器。

  { "mcpServers": { "council": { "command": "npx", "args": [ "agents-council@latest", "mcp" ] } } }

  注释：

  • mcpServers.council.name 或 server name：council，标识 MCP 服务器的注册名称。
  • command：用于启动 MCP 服务器的命令，这里为 npx。
  • args：启动命令的参数，包含包名和启动组件（本实现使用 mcp 子命令）。
  • 该配置用于 MCP 客户端对接，客户端本身不需要修改代码。

• 基本使用方法

  1. 启动 MCP 服务器：在支持 Node.js/Bun 的环境中执行 npx agents-council@latest mcp。
  2. 配置客户端：按照上面的 JSON 结构将 council 服务器添加到客户端的 MCP 配置中。
  3. 客户端交互：通过客户端工具（如 Claude/Codex/Gemini 等）对 council 服务器发出以下操作之一：start_council、join_council、get_current_session_data、send_response、close_council。
  4. 响应格式：默认返回 Markdown 输出，也可通过 -f json 切换为 JSON 输出（具体取决于服务器启动参数）。
  5. 监控与停止：根据需要停止服务器，或在出现异常时重启。