SuperAPI AI 工具集

releases-mcp

编程与开发

查看项目

更新于 11-06 07:33

技能介绍

用途

Releases MCP 是面向“发布记录与变更日志查询”场景的 MCP 服务器。它的核心用途是在用户询问某个库或产品的最新发布、变更日志、破坏性变更、版本更新或迁移信息时,读取实时登记数据,而不是依赖可能过时的训练数据。资料指出,训练数据对快速迭代的库而言往往是陈旧的,因此这些工具直接读取实时注册表。

主要能力

服务器对外暴露以下查询工具:

  • search:跨四个板块统一搜索,包括组织(orgs)、目录(catalog,含产品与独立来源)、集合(collections)和发布(releases),是默认入口。
  • get_latest_releases:获取近期发布,可按组织或产品限定范围,支持用 since / until 指定时间窗口。
  • list_organizations / get_organization:浏览与查看组织信息。
  • list_catalog / get_catalog_entry:浏览与查看目录条目,每个条目带有 entryType,取值为 "product" 或 "source"。get_catalog_entry 还可返回 CHANGELOG 片段。
  • get_release:根据 rel_ 开头的 id 获取单条发布的完整内容,id 来自 search 或 get_latest_releases 的结果。
  • list_collections / get_collection / get_collection_releases:获取跨组织的精选“播放列表”(例如 “Frontier AI Labs”“Coding Agents”),独立于分类体系。
  • lookup_domain:把 URL 或域名解析为拥有它的组织,适用于输入是网址而非名称的情况。
  • whats_changed(beta):查询某个包在两个版本之间的变更日志条目,调用形式为 whats_changed(package, from, to),返回 (from, to] 区间内的发布、摘要、破坏性变更判定和迁移说明;package 可以是受跟踪来源的 slug 或 GitHub 的 owner/repo,无需登录。

服务器还暴露已登录账户相关工具:follow / unfollow / list_follows、get_personalized_feed,以及 list_webhooks(只读)和 manage_webhook(创建 / 更新 / 删除 / 测试 / 轮换密钥)。这些工具操作用户自己的账户,需要已认证连接(“Sign in with Releases” OAuth 令牌或 relu_ 用户 API key),匿名客户端会返回错误。

使用方式

资料给出的查询流程如下:

  1. 解析实体:先用 search 加产品或公司名称,一次调用即可返回组织、目录、集合与发布;可用 type 收窄(如 type: ["catalog"] 仅查注册表,type: ["releases"] 只查发布内容)。若名称无法解析,可尝试用公司而非产品名、GitHub 组织名、域名(或直接使用 lookup_domain)、{org}/{repo} 形式的 GitHub 坐标。坐标匹配不区分大小写;若无匹配,注册表会按需探测 GitHub,并在响应中返回带 indexed / existing / empty / not_found / deferred 状态的 lookup 字段。
  2. 选择后续调用:问“最新发布”用 get_latest_releases;跨注册表关键词搜索用 search;要逐字引用某条发布用 get_release;查实体元数据用 get_catalog_entry 或 get_organization(组织可带 AI 概览预览,include_overview: true 获取完整简报);要完整维护中的 CHANGELOG.md,用 get_catalog_entry 并传 include_changelog: true,仅适用于跟踪已签入 CHANGELOG.md 的来源条目,产品与仅打标签的仓库(如 Next.js,发 GitHub releases 但无 CHANGELOG 文件)不会返回;大文件可传 changelog_tokens(建议档位 2000 / 5000 / 10000 / 20000)获取按标题对齐的片段,再通过返回的 nextOffset 续取,每次响应都会报告 totalTokens 以便预估调用预算;查精选主题流先用 list_collections 发现,再用 get_collection_releases 获取跨组织交错信息流。
  3. 对比产品:托管服务器没有 compare_products 或 summarize_changes 工具,需要分别拉取各产品数据(元数据用 get_catalog_entry,近期动态用 get_latest_releases),自行综合对比。两个产品都必须已被索引;若有一个未找到,应说明缺哪一个,而不是猜测。
  4. 呈现结果:先回答用户问题,尽可能带版本号与日期,简短引用发布说明中的关键变更;若结果稀疏,应说明该产品可能尚未被完整索引,不要编造发布信息。

适用场景

激活该技能的场景包括:用户询问某库或产品有什么新变化(如“Next.js 15 改了什么”)、想要近期发布或变更日志、询问破坏性变更或迁移(如“Prisma 6 有破坏性变更吗”)、想比较两个产品的发布活跃度(如“Bun 与 Deno 的发布对比”)、提到某产品的版本更新、发布说明或变更日志、询问精选主题信息流(如“AI 实验室们有什么新东西”)。

限制

  • 服务器不提供 AI 摘要或产品对比工具,需使用者自行从数据中综合。
  • 账户相关工具需要认证;匿名客户端调用会报错。
  • 组织概览、CHANGELOG 片段等能力有明确适用范围(例如 CHANGELOG 仅对跟踪已签入 CHANGELOG.md 的来源条目有效)。
  • Webhook 的 JSON 签名密钥仅在创建或轮换时显示一次;Slack 与 Discord Webhook 没有签名密钥。只有用户明确要求时才应创建、修改或删除 Webhook。
  • 若产品未被索引或查询结果稀疏,应如实说明,不得虚构发布信息。