mcp-api-change-monitor

API 变更监控 MCP 服务

这是一个 MCP 服务，用于连接 Mamba Labs 在 Apify 上提供的 API 弃用和破坏性变更监控 actor。提供 API 厂商或 URL 即可。每次运行都会将每个来源与上次运行保存的状态进行比较，并仅返回发生的变更。

包含内容

• 功能介绍
• 快速开始
• 先决条件
• 示例提示词
• 工具
• 输入
• 定价
• 你的密钥
• 完整 actor 文档
• 许可证

功能介绍

• 变更日志：从厂商的变更日志源或页面获取新增条目；如果措辞表明属于弃用或破坏性变更，则分别标记为 deprecation_notice 或 breaking_change，并注明首次提及的 sunset_date。
• 状态：从厂商的状态历史源获取新事件和状态变更。
• OpenAPI：从已发布的 OpenAPI JSON 文档中获取新增、移除或弃用的操作，以及 API 版本。
• 标头：检查你列出的 API 端点响应标头中的 Sunset 和 Deprecation。
• 每次运行中每个来源对应一行：使用 state_key 首次检查时生成 source_baseline，之后生成包含 changes_found 的 source_check；如果没有变化，则生成一条免费的 no_change 行。

所有工作都在 Apify 上运行。此软件包是一个轻量客户端，用于启动 actor 运行、等待运行完成，并返回数据集行。

快速开始

你需要 Node.js 18 或更高版本，以及一个带有 API 令牌的 Apify 账户。

将以下内容添加到你的 Claude Desktop 配置文件（claude_desktop_config.json）、Cursor 或任何 MCP 客户端中：

{
  "mcpServers": {
    "mamba-api-change-monitor": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-api-change-monitor"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

重启客户端。随后会出现 monitor_api_changes 工具。

先决条件

• Node.js 18 或更高版本。
• 从 console.apify.com/account/integrations 获取 Apify API 令牌，并将其设置为 APIFY_TOKEN。即使没有令牌，服务也会列出工具；但调用工具时需要令牌。

示例提示词

• “自上周以来，GitHub 或 OpenAI 是否宣布了任何弃用或破坏性变更？”
• “监控 Stripe 和 GitHub 的 OpenAPI 文档，并告诉我哪些操作已被移除或弃用。”
• “从昨天以来，Cloudflare 或 Vercel 状态页上是否出现了新事件？”

工具

monitor_api_changes。只有一个工具。参数示例：

{
  "vendors": [
    "github",
    "openai"
  ],
  "state_key": "api-watch-daily"
}

输入

Actor 面向买家的所有输入，原样提供。省略的输入使用 Actor 自身的默认值。数字和布尔值均以字符串形式发送。

输入	类型	描述
vendors	array	要监控的 API 供应商，每行一个。每个供应商会展开为读取其公开来源：变更日志、弃用页面、状态历史记录，以及有发布时的 OpenAPI 文档。可选值：github、stripe、shopify、hubspot、openai、anthropic、google-ads、twilio、slack、notion、atlassian、cloudflare、vercel、plaid
sources	array	要监控的其他公开 URL，每行一个：变更日志或发行说明页面、RSS 或 Atom 订阅源、弃用或停止服务日期页面、Statuspage 网站或其 history.rss 订阅源，或 OpenAPI 或 Swagger JSON 文档。将根据 URL 返回的内容检测类型
endpoint_urls	array	无需凭据即可调用的 API 端点，每行一个。读取响应标头中的 Sunset（RFC 8594）、Deprecation（RFC 9745）以及 Link 关系 deprecation、sunset 和 successor-version。仅发送 GET 请求
watch	array	对于供应商预设，可选值为：changelog、deprecations、status、headers、openapi。留空时，监控 changelog、deprecations、status 和 headers。openapi 会读取供应商的 OpenAPI 文档（最多 14 MB），并报告新增、移除或弃用的操作。若未包含 changelog，变更日志来源只会返回弃用和重大变更。你在 Source URLs 中列出的 URL 始终会被读取
keywords	array	仅返回标题、摘要、类别或操作中包含这些词语的变更行。每项变更仍会更新已保存的状态
only_deprecations_and_breaking	string	true 表示仅返回标记为弃用或重大变更的变更行、已移除或已弃用的 OpenAPI 操作，以及标头变更。不会返回事件和普通变更日志条目。默认值为 false
max_changes_per_source	string	每次运行每个来源返回的变更行数，范围为 1 至 1000。其余变更会计入 changes_found。默认值为 100
include_snapshot	string	true 表示在首次检查来源时，也返回该来源的当前条目、事件或操作，最多不超过每个来源的 Max change rows。快照中的每一行都会按快照行计费。默认值为 false
state_key	string	为已保存的状态命名，以便不同计划分别保留基准。具有相同状态键和来源的运行会相互比较
reset_state	string	true 表示忽略已保存的状态，并为每个来源记录新的基准。默认值为 false
max_charge_usd	string	可选。运行将在费用超过此金额之前停止
proxy_mode	string	获取来源的方式。默认值为 auto

定价

在 Apify 上按事件付费，费用计入你的 Apify 账户。价格以 USD 计。

事件	免费计划	Bronze	Silver	Gold
change-row，自上次运行以来，受监控来源上的一项变更：新增的变更日志条目、弃用通知或重大变更，新增或更新的状态事件，新增、移除或弃用的 OpenAPI 操作，API 版本变更，或 Sunset 或 Deprecation 标头变更	$0.0035	$0.003325	$0.00315	$0.002975
source-check，读取一个来源并与其已保存的状态进行比较：首次检查来源并记录基准，或后续检查中发现至少一项变更。内容未发生变化的来源会返回免费的 no_change 行，无法读取的来源也免费	$0.003	$0.00285	$0.0027	$0.00255
snapshot-row，首次检查来源时的一个当前条目、事件或操作，仅在启用 include_snapshot 时返回	$0.001	$0.00095	$0.0009	$0.00085
apify-actor-start，每次运行启动	$0.001	$0.001	$0.001	$0.001

内容未发生变化的来源会返回免费的 no_change 行，无法读取的来源免费，因输入被拒绝而返回的那一行也免费。

你的密钥

该 Actor 无需密钥。它会读取公开的更新日志、信息源、状态历史记录和 OpenAPI 文档，并在无需凭据的情况下调用你列出的端点。它不持有任何密钥。代理流量不会增加你的费用：Mamba Labs 会承担此次运行的平台费用。

Actor 完整文档

apify.com/mambalabs/api-change-monitor

许可证

MIT。请参阅 LICENSE。