基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
技术实践2026-11-20 17:30

远程 MCP 服务上线与登记实录

dev.to · AI#MCP#工具定义#服务部署
Editor brief · 编辑速览

RipSeek 在 Cloudflare Worker 上用单个无状态 Streamable HTTP 端点提供六个职责明确的只读工具。服务发布后进入 MCP 官方注册表,并在 Glama 的工具定义质量评估中获得 A 级。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

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 后,能否按提示先查有效值,再用新参数重试。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
用调用链定位智能体的延迟瓶颈
下一篇
小团队何时该给数据仓库加一层

资讯速览

dev.to · AI · 2026-11-20 17:30

AI 评分 8.0 / 10

相关标签

#MCP#工具定义#服务部署

继续阅读

  • 智能体跳过工具,结构化输出为何失效
  • 用调用链定位智能体的延迟瓶颈
  • 小团队何时该给数据仓库加一层
  • WhatsApp 机器人把报价和约见交给人工
  • 用音频、弹幕和低帧率视频定位直播高光