远程 MCP 服务上线与登记实录
RipSeek 在 Cloudflare Worker 上用单个无状态 Streamable HTTP 端点提供六个职责明确的只读工具。服务发布后进入 MCP 官方注册表,并在 Glama 的工具定义质量评估中获得 A 级。
AI 深度解读
RipSeek 把卡包价格、抽卡概率和近期抽取记录开放给 Claude、ChatGPT 和 Cursor 查询。上线不到一天,它进入了官方 MCP Registry,也出现在 Glama 上,工具质量拿到 A,评分 3.9/5,健康检查通过。
这次最值得抄的是工具接口的写法。作者把一个查询拆成模型能选对、填对、出错后还能改对的几步。这套做法可以直接用在已有 API 上,至于评分能否代表真实任务的成功率,原文没有给数据。
为什么只开一个端点和六个工具
RipSeek 用 Cloudflare Worker 提供一个远程 POST /mcp 端点,通过 Streamable HTTP 收发 JSON-RPC 消息。服务不保存会话,处理请求和普通 Worker 路由一样,无需为连续几次工具调用维护会话状态。
六个工具各管一件事。list_packs 和 get_pack 查卡包,search_cards 和 get_card 查卡,list_recent_pulls 看近期抽取记录,estimate_budget 估算预算。它们都无需登录,只读取数据。用户要买卖时,回到 RipSeek,在自己的钱包里确认。查询和交易的边界由产品流程保证。
工具描述怎么帮模型选对下一步
Glama 按 Tool Definition Quality Score(TDQS)给工具定义打分,3.5 分起就是 A。作者的写法是首句交代工具做什么、返回什么,接着说明什么时候该用它,什么时候该换另一个工具。描述还要交代它读取哪些数据、多久更新一次,例如卡池每几分钟重扫一次。
get_card 最能说明这种分工。模型手上只有卡名时,先调 search_cards,再把结果里的 nft 字段传给 get_card。后者返回当前卡池里一张 Rare 或 Epic 卡的名称、保险估值、图片,以及所有可能抽到它的卡包、包价和单包命中概率。卡刚被抽走时,工具会明确报错。参数也要给例子,例如 umbreon vmax 和 psa 10 rookie,让模型知道这些词都要出现在卡名里,顺序随意。
团队还提供允许额外字段的输出 schema,方便客户端校验结构化结果。四个注解分别是 readOnlyHint: true、destructiveHint: false、idempotentHint: true、openWorldHint: true。工具名用动词开头,把 recent_pulls 改成 list_recent_pulls 时保留旧名作为别名,已有调用可以继续工作。
Glama 首轮评审也指出了工具覆盖的问题。团队补了单卡查询 get_card,给 list_recent_pulls 加了过滤条件,再重写全部六条工具描述。业务查询失败时,服务在正常的工具调用结果里返回 isError: true,并告诉模型下一步怎么做。比如找不到 pokemon_5,就提示先调用 list_packs 获取有效代码。模型可以据此修正参数再试。
上架为什么先从官方 Registry 开始
团队先通过 mcp-publisher 发布 server.json,其中包含名称、描述、远程 URL 和图标。注册名需要证明命名空间归属。io.github.<org>/<server> 走 GitHub 验证,com.yourcompany/<server> 走自有域名的 DNS TXT 记录验证。作者建议有域名就用自己的,方便用户识别官方服务。
Glama 等目录会从 Registry 收录服务,团队随后可以在 Glama 认领条目、查看分析数据。部分 Awesome 清单要求 Glama 徽章,所以排在后面。有的清单要求描述少于 120 个字符,有的指定了数据文件里的提交位置。Claude 连接器目录则由公司从 Claude 管理设置提交,服务需要登录时须接入 OAuth,还要提供隐私政策,并逐个标明工具只读或具有破坏性。按原文的说法,该目录一般不接受加密货币软件。
我的判断
这篇最扎实的是把漏掉的查询能力补上了。只有搜索、缺少详情时,模型读懂描述也拿不到完整数据。相比把搜索、详情和估算塞进一个通用查询工具,拆开之后,每次调用所需的参数和返回结果更容易写清楚。至于拆开后选错工具的次数会少多少,作者没有给对照测试。这是接口设计上的经验之谈。
3.9/5 和健康检查是团队报告的上架结果。团队同时改了工具覆盖、过滤条件和描述,原文既没给初始分,也没拆开测每项改动的效果。免登录同样有前提。RipSeek 开放的是本来就能公开查询的数据,涉及用户私有数据的 API 得先解决授权问题。
能拿来做什么
- 给已有公开 API 做 MCP 封装时,可以按作者的建议先选 5 到 10 个用户常问的问题。选工具时对照产品里的真实问法,优先覆盖列表、搜索和详情之间的常见跳转。
- 在 Node 接入层写工具定义时,把每个参数的真实示例、返回字段和下一步调用写进去。用「先按名称搜索,再拿结果字段查详情」走一遍,确认客户端能把两次调用接起来。
- 给无效代码和数据过期准备可操作的错误结果。检查调用方拿到
isError: true后,能否按提示先查有效值,再用新参数重试。