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:在最近报告中按关键词搜索并返回匹配片段
-
安装与部署(自托管/云端部署)
- 进入 mcp 目录
- 安装依赖
- 使用 npm/yarn/pnpm 之一安装(仓库中使用 pnpm/wrangler 的自托管方式)
- 部署
- 使用 Wrangler 将 Cloudflare Worker 部署到云端,例如 wrangler deploy
- 运行后要能对外提供 HTTP(S) 端点,供 MCP 客户端连接
- 服务健康接口: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" }
-
基本使用方法
- 部署完成后,客户端通过 JSON-RPC 与 MCP 服务器对接。初始化后可调用工具集合并请求文本内容。
- 常用交互(示例说明,不作为代码):
- 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
- 返回内容格式为 MCP 兼容的 JSON-RPC 响应,文本以 "text" 字段呈现,供客户端渲染或处理
-
运行与测试建议
- 本地或云端部署完成后,通过 Health/Hello 路径确认可访问性
- 使用一个简单的 MCP 客户端(如 Claude OpenClaw、Claude Desktop)尝试执行 list/get/get_latest/search 以验证互通性