使用说明（Markdown 格式）

• 项目简介 Debate Agent MCP 服务器是一个遵循 MCP 标准的后端服务，用于向本地 LLM 客户端提供统一的上下文信息与功能能力。它托管并管理资源、注册与执行工具、并定义/渲染 Prompts，确保 LLM 客户端能够通过标准化接口读取 diff、执行工具、发起代码审查/计划等操作。

• 主要功能点

  • 资源与工具管理：提供 list_agents、read_diff、run_agent、debate_review、debate_plan、debate_360 等工具，以 JSON-RPC 形式对外暴露接口。
  • MCP 协议实现：实现与客户端的请求/响应交互，基于 MCP 的工具注册与调用语义，通过 JSON-RPC 进行通信。
  • 本地执行能力：服务器端通过 spawn/CLI 调用本地已安装的代码审查代理（如 Claude、Codex 等），执行代码审查、计划编制等任务。
  • 模板与规则：内置 Prompts（review、plan）和平台规则，确保审查与计划过程的一致性与可扩展性。
  • 本地化工作流：支持 360 序列化审查，包括多轮交叉评审、合并输出、并生成 Markdown 报告。
  • 拓展性：可通过配置文件增加/修改代理、 debate 配置、平台规则等，便于在本地环境自定义使用。

• 安装步骤

  • 准备环境
    • 需要 Node.js 环境（建议版本符合仓库要求的 Node.js 版本）。
  • 获取代码
    • 将仓库克隆到本地或下载源码。
  • 构建/安装
    • 使用仓库提供的构建脚本或包管理工具构建 core、mcp-server、VSCode 扩展等包。
  • 运行 MCP 服务器
    • 启动 MVC 服务器通常通过 npx @debate-agent/mcp-server 或等效命令启动（具体命令以安装方式为准）。
  • 配置 Claude/Codex 等本地 CLI
    • 在 debate-agent.config.json（示例配置）中按需添加 agent 条目（codex/claude 等），确保本地 CLI 已正确安装与认证。

• 服务器配置 服务器对 MCP 客户端的连接配置示例（请根据实际部署位置替换路径）： { "server": { "name": "debate-agent", "command": "node", "args": ["/path/to/debate-agent-mcp/packages/mcp-server/dist/index.js"] }, "notes": "以上路径为典型打包输出位置，请根据实际部署位置调整。MCP 客户端需要使用该服务器的启动命令与参数建立连接。" }

• 基本使用方法

  • 启动服务器后，MCP 客户端可以通过标准的 JSON-RPC 请求调用以下工具：read_diff、run_agent、debate_review、debate_plan、debate_360、list_agents。
  • 客户端通过提供输入（如问题、diff、代理列表等）来发起对应请求，服务器返回 JSON-RPC 响应或通知。
  • 如需 360 序列化审查，请求 debate_360，服务器会按配置执行初始并行评审、360 交叉评审、结果合并与报告生成等流程。

• 其他说明

  • 服务器默认依赖本地已安装的 CLAUDE/CODEX 等 CLI，确保本地环境具备相应可执行文件与认证信息。
  • 本实现包含了 360 序列化审查、计划审查、以及多种结果报告生成功能，便于调试与扩展。