Skip to main content
Glama
deenesjakoruzh
dhughes6071

driftwatch-mcp

by dhughes6071
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

driftwatch

npm license node

面向 AI 编程智能体的依赖迁移情报。

精确地回答一个问题，并附上引用来源：

这个库从 A 版本升级到了 B 版本。什么被破坏了？我的代码需要做哪些修改？

第一次来？从入门指南开始。

安装（30 秒）

把它添加到 Claude Desktop、Claude Code、Cursor 或任何 MCP 客户端：

{
  "mcpServers": {
    "driftwatch": {
      "command": "npx",
      "args": ["-y", "driftwatch-mcp"]
    }
  }
}

这就是全部配置。无需 API 密钥、无需账户、无需付费、无需配置。 引擎在你的机器上本地运行，只读取公开数据——npm、PyPI、GitHub Releases 和 OSV.dev。

你的智能体里会出现两个工具：

工具

功能

get_migration_delta

A 版本和 B 版本之间有哪些破坏性变更，每条结论都附有引用来源

check_package

这个包真的存在吗？在安装前捕获幻觉生成的包名和拼写仿冒的包名

可选：设置 ANTHROPIC_API_KEY，可以在确定性结果之上附加 LLM 综合生成的迁移步骤。没有它也能完全正常工作。

Related MCP server: MCP Workflow Engine

为什么存在

每个 LLM 都冻结在训练截止点。库不会。当智能体针对比自己截止点更新的版本编写代码时，它会自信地生成一个已不存在的 API——然后大约要烧掉六次失败的构建修复迭代，才能逼近真相。

SDKProof 基准测试（2026 年 7 月） 对此进行了实测：模型在 Prisma v7 上得分 80/100（v6 的 PrismaClient 模式已被移除），在 Vercel AI SDK v5+ 上得分 90/100（参数被重命名，maxSteps 被删除）。

Without driftwatch:  ~6 failed iterations x ~15k tokens  ->  $0.30-$1.50 + 10-20 min
With driftwatch:     1 call                              ->  $0.05

6–30 倍的回报，买家可以自行计算。无需信任。

快速开始

npm install
cp .env.example .env
npm start
# The product
curl "localhost:4021/v1/delta?ecosystem=npm&name=react&from=18.2.0&to=19.0.0"

# Free safety check -- catches hallucinated and typosquatted packages
curl "localhost:4021/v1/check?ecosystem=npm&name=recat"

在支付和付费 AI 功能都关闭的情况下运行。零成本。

你会得到什么

{
  "package": "react",
  "from": "18.2.0", "to": "19.0.0",
  "jump": { "kind": "major", "majorsCrossed": 1, "releasesInRange": 583 },
  "tier": "evidence",
  "breakingChanges": [
    {
      "summary": "Removed: `ReactDOM.render`, `ReactDOM.hydrate` ...",
      "version": "19.0.0",
      "confidence": "medium",
      "symbols": ["ReactDOM", "render", "hydrate"],
      "citations": [{ "kind": "release-note", "url": "https://github.com/..." }]
    }
  ],
  "advisories": [],
  "citations": [ /* every source we relied on */ ]
}

每一条结论都链接到一手来源。我们发布事实和简短引用——绝不转载整篇文档。

架构

                 ┌──────────────────────────────────────────┐
                 │   FREE PUBLIC SOURCES  (no licensed data) │
                 │   npm · PyPI · GitHub Releases · OSV.dev  │
                 └────────────────────┬─────────────────────┘
                                      │
                          ┌───────────▼───────────┐
                          │   ENGINE               │
                          │  ┌──────────────────┐  │
                          │  │ deterministic    │  │  always on, $0
                          │  │ extraction       │  │
                          │  └────────┬─────────┘  │
                          │  ┌────────▼─────────┐  │
                          │  │ LLM synthesis    │  │  OPTIONAL, capped
                          │  │ (off by default) │  │
                          │  └────────┬─────────┘  │
                          └───────────┼────────────┘
                                      │
                          ┌───────────▼───────────┐
                          │  SQLite PERMANENT CACHE│  ← the margin
                          │  + revenue ledger      │
                          └───────────┬───────────┘
                                      │
              ┌───────────────────────┼───────────────────────┐
              │                       │                       │
      ┌───────▼───────┐      ┌────────▼────────┐    ┌────────▼────────┐
      │  MCP server   │      │   HTTP API      │    │  x402 layer     │
      │  (stdio)      │      │   + OpenAPI     │    │  (Base, USDC)   │
      │               │      │                 │    │                 │
      │ DISTRIBUTION  │      │    REVENUE      │    │   OPTIONALITY   │
      └───────────────┘      └─────────────────┘    └─────────────────┘

一句话概括策略： MCP 拥有用户，API 拥有收入，x402 是低成本的定位策略。原因见 DECISION.md，实测证据见 MARKET_RESEARCH.md。

端点

端点

价格

用途

GET /v1/delta

$0.05

核心产品——两个版本之间的破坏性变更

POST /v1/manifest

$0.15

批量分析，最多 50 个包

GET /v1/check

免费

这个包存在吗？是否是拼写仿冒？

GET /health

免费

存活检查

GET /openapi.json

免费

机器可读的规范

GET /llms.txt

免费

智能体可读的摘要

GET /.well-known/x402

免费

支付发现

GET /admin/stats

localhost

收入和成本台账

生态：npm、PyPI。

MCP 服务器

分发渠道。两个工具：get_migration_delta 和 check_package。

以 driftwatch-mcp 发布——上方安装一节就是那段配置。

要从克隆的仓库而不是 npm 运行：

{
  "mcpServers": {
    "driftwatch": {
      "command": "node",
      "args": ["--experimental-strip-types", "/path/to/driftwatch/src/mcp/server.ts"]
    }
  }
}

默认在本地运行引擎——不向我们发起网络调用，无需付费。设置 DRIFTWATCH_REMOTE_URL 可以将其指向托管的实例。

不需要原生依赖。 better-sqlite3 是可选的；如果它无法在你的机器上编译，服务器会回退到纯 JSON 缓存，行为完全相同。原生编译失败是 MCP 服务器安装时挂掉的最常见原因，而这个服务器能扛过去。

命令

npm start           # run the API server
npm run dev         # run with auto-reload
npm run mcp         # run the MCP server (stdio)
npm test            # unit tests -- no network, no cost
npm run testclient  # simulate a customer end to end
npm run wallet:new  # generate a TESTNET wallet

安全：一段话讲清楚

这个服务器从不持有私钥。 接收加密货币只需要一个公开地址；只有支出才需要密钥，而我们只收不付。即使服务器被攻破，攻击者得到的也只是缓存和台账——拿不到资金，因为根本没有资金可拿。LLM 支出按日封顶，每次调用前都会检查。完整细节：docs/SECURITY.md。

诚实的现状

已发布，但还没有人使用。 截至 2026 年 8 月 23 日，npm 包已经上线，并已通过冷安装验证可以正常工作，但目前有零个自然用户。这就是诚实的现状：代码没问题，分发还没有开始。

这是一个未经验证的业务。 以下为实测数据：

  • 整个独立的 x402 卖家经济体约为 ~$11,700/月，覆盖 14,128 个注册服务（2026-08-07 测量——见 MARKET_RESEARCH.md）。

  • 表现最好的独立运营者收入约为 ~$872/月。

  • 大多数编程智能体运行在用户的订阅内，没有钱包。

所以：可以预期免费 MCP 的使用量会远远超过付费调用，也可以预期 x402 在第一年的收入接近零。这个服务的设计使得这种结果每月只花费 ~$1，同时仍然能产出真正有用的东西。

真正重要的指标不是收入——而是每个唯一付费者的调用次数。低于 5 意味着观光客。高于 20 意味着真正的业务，即使收入微薄。

文档

文件

内容

BEGINNER_GUIDE.md

所有内容，用通俗的语言讲清楚

MARKET_RESEARCH.md

x402、MCP 和智能体支付的实测现状

OPPORTUNITIES.md

考虑过的 20 个业务，按优先级排序

DECISION.md

为什么选这个，以及诚实的注意事项

PROJECT_STATUS.md

已完成 / 进行中 / 下一步

docs/SECURITY.md

密钥托管、支出控制、威胁模型

docs/ECONOMICS.md

单位经济模型和三种情景

docs/COSTS.md

每一项经常性成本，在你投入之前

docs/DEPLOYMENT.md

Mac Mini → 互联网 → 主网 → VPS

DAY_1.md … MONTH_1.md

具体的发布计划

数据来源与伦理

所有输入都是免费、公开且无需许可的：npm registry、PyPI、GitHub Releases 和 OSV.dev。

我们刻意不转售需要许可的数据。目前收入最高的独立 x402 运营者在代理付费 API（People Data Labs、Exa、Firecrawl），这很可能违反了其服务条款。那是唯一一个在 x402 上被证明可行的商业模式，而我们排除了它。

我们发布事实，并附上简短引用和链接——绝不转载文档。

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Package Intel MCP

    Package intelligence for AI agents across npm, PyPI, crates.io and deps.dev. No API keys.

  • package-intel-mcp

    npm, PyPI & crates.io intel for AI agents: versions, popularity, deps, health. No API keys.

  • FactReason

    Check exact npm/PyPI upgrades for evidence-backed breaking changes; query APIs and components.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dhughes6071/driftwatch'

If you have feedback or need assistance with the MCP directory API, please join our Discord server