RipSeek 是我们的产品之一,它有一个远程 MCP 服务器:Claude、ChatGPT、Cursor 这类 AI 应用可以向它询问 Collector Crypt 的卡包(概率、每个包里最值钱的卡、最近开出的卡),拿到即时的答案。发布后不到一天,它就进了官方 MCP Registry 和 Glama,在 Glama 的工具质量评分拿到 A(3.9 / 5),状态健康。下面是真正起作用的部分。
服务器本身:刻意做得小而无聊
- 远程、Streamable HTTP、无状态。 Cloudflare Worker 上一个
POST /mcp端点回应 JSON-RPC。不用存会话,所以它跟其他 Worker 路由一样容易扩展。 - 只读,不用登录。 每个工具都只读取资料,不能通过它买卖任何东西;要操作,用户得回到产品里,在自己的钱包确认。只读工具也是 AI 代理和目录最信任的一种。
- 六个工具,各做一件事。
list_packs、get_pack、search_cards、get_card、list_recent_pulls、estimate_budget。
好的工具说明长什么样
Glama 评的是每个工具的定义,不是你的宣传文案。它的标准公开为 Tool Definition Quality Score(TDQS);最高等级是 A,3.5 分以上。评分高、AI 代理也真的会选对的说明,都遵循同一个模式:
- 第一句:做什么、回传什么。
- 什么时候用它,什么时候该用别的工具。 代理就是靠读这些在你的工具之间做选择,要写得直白。
- 会碰到什么、资料多新。 例如「只读;卡池每几分钟重新扫描一次」。
- 每个参数都附例子。 不只写类型:
"Words that must all appear in the card name, any order, e.g. 'umbreon vmax' or 'psa 10 rookie'." - 输出格式(output schema),让会验证结构化结果的客户端知道会拿到什么。我们写得比较宽松(允许多出来的栏位),严格的客户端也不会拒收。
- 标注(annotations):
readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true。 - 名称用动词开头:
list_recent_pulls,而不是recent_pulls。改名时旧名称继续当别名可用,没有任何客户端因此出错。
一个真实的例子,get_card:
Shows one Rare or Epic card that is in a pack pool right now: name, insured value, picture, and every pack it can come from with that pack's price and the chance per pack of pulling this exact card. Use it after search_cards, passing the nft field of a result; use search_cards when you only have a card name. Read-only; fails with a clear message if the card has just been pulled.
Glama 第一次评审时,除了文字,也指出了功能上的缺口:它建议把某个工具的输出写清楚,并增加查单张卡的方式。我们因此新增了 get_card,也给 list_recent_pulls 加了筛选。之后,六个工具的说明全部照上面的模式重写。
错误讯息也是接口的一部分
工具答不出来时,回传一个带 isError: true 的正常结果,加上一句模型看得懂、能照着做的话(例如「没有代码是 pokemon_5 的卡包。请先调用 list_packs 查看代码。」),而不是协议层的错误。代理读到后会修正参数再试一次,而不是直接放弃。
上架的先后顺序
- 先上官方 MCP Registry。 用 Anthropic 的
mcp-publisher工具发布一份server.json(名称、说明、远程网址、图标)。名称是一个你要证明拥有的命名空间:通过 GitHub 的io.github.<组织>/<服务器>,或通过你域名上的 DNS TXT 记录的com.yourcompany/<服务器>。有自己的域名就用域名:这等于告诉所有人,这是官方的服务器。 - Glama 和其他目录会从注册表自动收录。 我们的服务器不到一天就出现在 Glama,附上评分和健康检查。在 Glama 认领后可以看分析数据。
- 最后才是各个 awesome 列表。 有些列表要求先有 Glama 徽章,所以放最后。每个列表的贡献规则都要读:有的要求说明不超过 120 个字符,有的要求插在资料档的指定位置。
- Claude 连接器目录要由公司自己从 Claude 的管理后台送审;服务器需要登录的话必须用 OAuth,还要有隐私政策,每个工具都要标明只读或具破坏性。它一般不收加密货币软件。
给 API 公司的建议
如果你已经有公开 API,MCP 服务器大部分是翻译工作:挑出用户最常问你产品的 5 到 10 件事,每件照上面的模式写成一个工具,一开始先做只读,并且在别人用他们的名义包装你的 API 之前,先用你自己的域名发布。注册表里已经有数以百计、由第三方基于别家公司 API 做的非官方服务器。
我们帮其他团队做这件事:建在你现有的 API 上、放在你自己的域名下、上架注册表和主要目录,US$500 起。详见我们的服务页。