Coding Agent Hub MCP 服务器

使用说明（简要、易操作的步骤）：

• 项目简介
  • Coding Agent Hub 是一个基于 MCP 的后端服务器，提供对多种编码相关后端 CLI 的统一访问，支持单轮和多轮对话（会话）。它通过插件系统实现对各个后端 CLI 的封装和能力探测，并可将会话历史注入到后端调用中，给 LLM 客户端提供稳定的上下文服务。
• 主要功能点
  • MCP 服务器端实现：暴露工具、会话管理工具以及会话相关流程，使用 JSON-RPC 风格与客户端交互。
  • 后端适配器与插件运行时：内置多种后端适配器（Claude、Gemini、Codex、OpenCode、Copilot、Cursor、Generic），并通过插件运行时实现能力探测与原生会话/Hub 模式切换。
  • 会话管理与持久化：Hub 会话支持多 turns 的历史记录、自动 trimming、延时自动清理等，同时可选的文件系统持久化。
  • 支持多传输与 JSON-RPC：当前实现示例通过 MCP 服务器与客户端进行通信，且具备会话相关工具的注册与执行能力。
  • 安全性与容错：包含能力探测失败的回退机制、超时处理、错误分类与可观测的日志输出。
• 安装步骤
  • 直接使用 MCP 客户端连接本服务器（推荐），示例参考 README 的用法：
    • 本仓库提供的 MCP 服务可以通过 npx 包装直接启动，或者在 Claude/GPT 等客户端中以 stdio 传输接入。
  • 作为独立库使用时，请先安装相关依赖并在项目中引入核心服务模块，使用 createHubServer 启动 MCP 服务并挂载到你自己的传输实现上。
• 服务器配置 为 MCP 客户端提供的连接配置示例（JSON 格式，供客户端使用配置服务器连接参数）： { "serverName": "coding-agent-hub", "transport": "stdio", "command": "npx", "args": ["-y", "@narai/coding-agent-hub"], "notes": "MCP 客户端通过 stdio 传输连接到服务器，启动命令与参数如上所示。" } 说明：
  • serverName：服务器唯一标识名称，客户端在配置时可引用。
  • transport：传输协议，此处为 stdio，表示通过标准输入输出进行 JSON-RPC 通信。
  • command/args：客户端启动服务器的命令及参数，示例与仓库 README 的用法一致，确保在运行环境具备 npm/npx 支持。
• 基本使用方法
  • 启动：按照上述配置在 MCP 客户端中加载服务器并建立连接，随后即可向 hub-agent、hub-session-start、hub-session-message 等工具发起请求。
  • 常用工具：
    • hub-agent：一次性调用任意后端 CLI，支持指定后端、模型、工作目录、超时等参数。
    • hub-session-*：创建、持续对话和管理会话，用于多轮对话的上下文连续性。
  • 警告与依赖： hub 运行前应具备所需后端 CLI、相应的 API key/凭证，以及本仓库列出的依赖项。