mcp-l402-gate-example

一个极简的 MCP 服务器，展示了 @powforge/mcp-l402-gate 的实际应用。

该服务器提供一个工具 bitcoin_data，用于从 mempool.space 获取当前的 BTC/USD 价格以及推荐的内存池费用。每次调用都受到以下门控限制：

1. L402 闪电网络发票（调用者按次支付 sats）。

2. 针对公共 PowForge 预言机的身份深度（DoI）评分查询。如果低于阈值，即使付费也无法通过。

L402 本身证明了调用者已付费。L402 + DoI 证明了他们不仅付费，而且拥有一个跨会话持续存在且伪造需要不可逆工作量的公钥声誉。后半部分是大多数 MCP 计费套件所忽略的。

快速开始

git clone https://github.com/zekebuilds-lab/mcp-l402-gate-example
cd mcp-l402-gate-example
cp .env.example .env       # fill in GATE_HMAC_SECRET and LNBits creds
npm install
npm start

服务器在启动时会记录工具 URL 和预言机地址。默认端口为 3100。

Related MCP server: l402-kit-mcp

使用 curl 进行测试

首次调用没有认证，因此门控返回 402 状态码和发票：

curl -i -X POST http://localhost:3100/tools/bitcoin_data \
  -H 'Content-Type: application/json' \
  -H 'X-Caller-Pubkey: 02a1b2c3...your-hex-pubkey' \
  -d '{}'

预期响应：

HTTP/1.1 402 Payment Required
WWW-Authenticate: L402 macaroon="...", invoice="lnbc1..."
Content-Type: application/json

{
  "error": "payment required",
  "macaroon": "...",
  "invoice": "lnbc1...",
  "payment_hash": "..."
}

支付 invoice 字段（使用任何闪电网络钱包），获取原像（preimage），然后重试：

curl -i -X POST http://localhost:3100/tools/bitcoin_data \
  -H 'Content-Type: application/json' \
  -H 'X-Caller-Pubkey: 02a1b2c3...your-hex-pubkey' \
  -H 'Authorization: L402 <macaroon>:<preimage>' \
  -d '{}'

你将获得 BTC 价格、内存池费用估算以及调用者的 DoI 评分。

对于检查工具目录的 MCP 客户端，清单也会被暴露：

curl http://localhost:3100/manifest.json

配置

DoI 评分阈值

这些与预言机返回的 rank 分桶相同。请根据错误调用所带来的代价选择合适的阈值：

门控工作原理

如果没有门控，402 + 宏流程仅证明调用者支付了 10 sats。一个新的攻击者钱包支付同样的 10 sats 即可通过。这只是格式上的合规，对滥用的控制较弱。

@powforge/mcp-l402-gate 保留了 L402 发票并增加了第二项检查：当宏验证通过时，门控会为调用者的公钥调用 DoI 预言机，获取 Schnorr 签名的评分，并将其与 MIN_SCORE 进行比较。该评分由四个维度（社交、访问、担保、经济）上可观察的不可逆工作量组成，因此一个新的女巫攻击者无法在短时间内刷出高分。

完整的故障模式表位于 @powforge/mcp-l402-gate README。

文件

• server.js - MCP 服务器，约 110 行代码。

• .env.example - 复制到 .env 并填写。

• package.json - 依赖于 express 和 @powforge/mcp-l402-gate。

链接

• npm: @powforge/mcp-l402-gate

• 文档与定价: powforge.dev/mcp

• 公共 DoI 预言机: identity.powforge.dev

许可证

MIT。