de en es ja ko ru zh

driftwatch-mcp

Name: driftwatch-mcp
Author: dhughes6071

by dhughes6071

Overview Schema Source Related Servers Discussions Admin

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: DepHealth MCP

为什么存在

每个 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 deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityActive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Package Intel MCP A
com.datakoot
Package intelligence for AI agents across npm, PyPI, crates.io and deps.dev. No API keys.
Developer Tools Code Analysis
61
Package Intel MCP A
io.github.selflabbs
Package intelligence for AI agents across npm, PyPI, crates.io and deps.dev. No API keys.
Developer Tools Code Analysis
2
Jeevesus — DugganUSA Threat Intelligence MCP A
io.github.pduggusa
check-package: block malicious npm/PyPI deps before your AI agent installs them. Free, no key.
Security Search Research & Data
72
FactReason A
io.github.factreason
Check exact npm/PyPI upgrades for evidence-backed breaking changes; query APIs and components.
Developer Tools Code Analysis AI & Machine Learning
111

Related MCP Servers

Dependency Freshness MCP
Developer Tools CI/CD & DevOps
Armigerous
A
license
A
quality
C
maintenance
Checks npm and PyPI packages for outdated versions, deprecation status, and breaking changes with cited sources, enabling AI agents to verify dependency freshness.
Updated 4 months ago (2026-06-12 20:34 UTC)
1
7 npm
ISC
DepHealth MCP
Security Code Analysis
hasarahman
A
license
A
quality
F
maintenance
Dependency security & health auditing for AI agents with no account or API key required.
Updated 3 months ago (2026-07-04 22:58 UTC)
2
2
MIT
Security Intel MCP
Security Penetration Testing
datakoot
A
license
Not graded
quality
B
maintenance
Vulnerability intelligence for AI agents that enables CVE lookup, package vulnerability checks, and dependency auditing without API keys.
Updated 4 days ago (2026-10-09 08:47 UTC)
MIT
package-intel-mcp
Developer Tools Code Analysis Research & Data
datakoot
A
license
Not graded
quality
B
maintenance
Provides software supply-chain intelligence for AI agents, enabling them to query package metadata, versions, downloads, dependencies, and health signals for npm, PyPI, and crates.io packages without API keys.
Updated 4 days ago (2026-10-09 08:47 UTC)
39 npm
MIT