agents-radar MCP 服务器实现(Cloudflare Worker)

  • 项目定位与作用

    • 该仓库包含一个 MCP 服务器实现,接收 JSON-RPC 请求并返回 agents-radar 摘要数据的文本内容,支持 list_reports、get_report、get_latest、search 等工具调用。实现了 initialize、工具查询、错误处理和跨域访问等基本功能,适合作为 OpenClaw、Claude Desktop 等 MCP 客户端的后端数据源。
  • 主要功能点

    • list_reports:列出最近 N 天可用的 Digest 报告及类型
    • get_report:获取指定日期和类型的完整摘要文本
    • get_latest:获取某一类型的最近报告
    • search:在最近报告中按关键词搜索并返回匹配片段
  • 安装与部署(自托管/云端部署)

    1. 进入 mcp 目录
    2. 安装依赖
      • 使用 npm/yarn/pnpm 之一安装(仓库中使用 pnpm/wrangler 的自托管方式)
    3. 部署
      • 使用 Wrangler 将 Cloudflare Worker 部署到云端,例如 wrangler deploy
    4. 运行后要能对外提供 HTTP(S) 端点,供 MCP 客户端连接
    5. 服务健康接口:GET / 返回工具列表与服务器基本信息,POST / 处理 JSON-RPC 请求
  • 服务器配置(供 MCP 客户端接入使用的示例配置) 说明:MCP 客户端需要提供服务器连接信息(名称、启动命令与参数等),以便建立与 MCP 服务器的连接。以下为参考配置(请按实际部署环境替换 URL 等字段): { "serverName": "agents-radar", "command": "wrangler", "args": ["deploy"], "transport": "https", "url": "https://agents-radar-mcp.duanyytop.workers.dev" }

  • 基本使用方法

    1. 部署完成后,客户端通过 JSON-RPC 与 MCP 服务器对接。初始化后可调用工具集合并请求文本内容。
    2. 常用交互(示例说明,不作为代码):
      • initialize:协商协议版本与能力
      • tools/list:获取可用工具清单(list_reports、get_report、get_latest、search)
      • tools/call:对指定工具发起调用并传入参数
        • 如 list_reports,传入 days
        • 如 get_report,传入 date(YYYY-MM-DD)和 type(如 ai-cli, ai-web 等)
        • 如 get_latest,传入 type
        • 如 search,传入 query 与 days
    3. 返回内容格式为 MCP 兼容的 JSON-RPC 响应,文本以 "text" 字段呈现,供客户端渲染或处理
  • 运行与测试建议

    • 本地或云端部署完成后,通过 Health/Hello 路径确认可访问性
    • 使用一个简单的 MCP 客户端(如 Claude OpenClaw、Claude Desktop)尝试执行 list/get/get_latest/search 以验证互通性

服务器信息