SuperAPI AI 工具集

lightning-enable-mcp

lightning-enable-mcp 是一个开源的 MCP(Model Context Protocol)服务器,让 AI 智能体能够进行比特币闪电网络支付并参与智能体之间的商业活动。它提供钱包、发票、L402 付费 API 访问、预算控制和 API 发现等工具,开箱即用,仅需配置一个钱包即可。支持 .NET 和 Python 两种实现。该服务器支持 Strike、NWC(Nostr Wallet Connect)、LND 等钱包,其中 OpenNode 仅支持开票和直接支付,无法支付 L402 挑战。通过 L402 生产者工具,用户还可以将自己的 API 按次收费出售;通过智能体服务协议(ASA)工具,智能体可在 Nostr 上进行服务发现、请求、结算和评价。服务器内置预算限制、持久化收据日志和人工确认流程,保障支付安全。生产者和 ASA 工具需要 Agentic Commerce 订阅(49 美元/月)解锁,但智能体可通过 create_lightning_enable_account 工具支付约 100 sats 激活费自助开通。代码以 .NET 和 Python 两套端口维护,最新版本为 v3.0.0,旧工具名已弃用。

访问官网

工具介绍

用途

lightning-enable-mcp 是一个开源 MCP 服务器,为 AI 智能体提供比特币闪电网络支付能力,使其能够支付发票、访问 L402 付费 API、创建收款发票、跟踪支出,并参与智能体之间的商业交易。该项目属于 Lightning Enable 基础设施的一部分,旨在支持基于闪电网络的智能体商业。

主要能力

  • 支付发票:通过闪电网络向任何 BOLT11 发票发送比特币。
  • 访问 L402 API:自动支付 L402 挑战,实现无缝 API 访问。
  • 发现 API:搜索 L402 API 注册表,按关键词或类别查找付费 API,或获取特定 API 的清单以了解端点详情和定价。
  • 跟踪支出:提供预算限制、持久化收据日志和余额检查。
  • 创建发票:生成发票以接收付款。
  • 钱包操作:查询 BTC 价格、货币兑换以及链上发送(Strike 支持;链上发送还支持 LND)。
  • 自助开通账户:通过 create_lightning_enable_account 工具,支付约 100 sats 的激活费(通过 L402),即可获得商户 API 密钥,无需浏览器或结账页面,并解锁生产者和 ASA 工具。
  • 出售服务(L402 生产者):设置卖家账户,将 API 置于 L402 之后,为路由定价,公开列出,生成支付挑战并验证付款令牌——全部通过一个工具完成。
  • 智能体商业(ASA):在 Nostr 上发现、请求、结算和评价智能体之间的服务。

使用方式

  1. 首次运行 — 设置钱包:使用 setup_wallet 工具。无参数时,它会报告已配置的钱包及其凭据来源(不会暴露凭据本身)。如果没有钱包,它会返回设置步骤。
    • 最短路径是 NWC:在支持 NIP-47 的钱包应用(如 Alby Hub、CoinOS)中创建 Nostr Wallet Connect 连接,复制 nostr+walletconnect:// 字符串,交给智能体。setup_wallet 会验证字符串、连接钱包证明其可用,然后写入 ~/.lightning-enable/config.json 并限制文件权限。之后需重启服务器。
    • 也可通过环境变量设置:Strike 使用 STRIKE_API_KEY;NWC 使用 NWC_CONNECTION_STRING;LND 使用 LND_REST_HOST + LND_MACAROON_HEX(自签名证书需设置 LND_TLS_CERT_PATH,可选 LND_FEE_LIMIT_SATS、LND_PAYMENT_TIMEOUT_SECONDS)。
    • 优先级:LND > NWC > Strike > OpenNode;环境变量优先于配置文件。
    • OpenNode 仅适用于开票/直接支付,不返回原像(preimage),无法支付 L402 挑战。
  2. 验证完整流程 — test_l402_payment:支付一个公开的 1 sat L402 端点,端到端验证钱包连接、原像返回和 L402 支付能力,花费约 1 satoshi。
  3. 实际使用:例如在 Lightning Enable Store 购买 T 恤(需要已充值的钱包和收货地址)。
  4. Claude Desktop 手动安装(MCPB 包):从 mcpb/ 目录获取打包的 MCPB 包,用 npx -y @anthropic-ai/mcpb pack mcpb lightning-enable-mcp.mcpb 本地构建,或从 CI 下载 .mcpb 产物,然后双击或拖入 Claude Desktop 的设置 → 扩展,通过其设置界面输入钱包凭据。
  5. Claude Desktop 配置:使用 dotnet tool install -g LightningEnable.Mcp 安装命令。在 claude_desktop_config.json 中添加配置。配置文件位置:Windows %APPDATA%\Claude\claude_desktop_config.json;macOS ~/Library/Application Support/Claude/claude_desktop_config.json;Linux ~/.config/claude/claude_desktop_config.json。
  6. 托管部署:超过自动批准阈值的支付需要人工确认。服务器生成 6 位一次性确认码,发送给操作员,智能体只有在你读回代码后才能继续。确认码不会出现在工具结果中。确认码有效期默认 120 秒(可配置 30-900 秒),绑定金额、工具和目标,最多同时存在 3 个,连续 5 次无效尝试将撤销所有待处理确认码。

支持的钱包

  • Strike:STRIKE_API_KEY,从 https://dashboard.strike.me 获取。
  • NWC:NWC_CONNECTION_STRING,来自 CoinOS / CLINK / Alby Hub。
  • LND:LND_REST_HOST + LND_MACAROON_HEX,自签名证书需 LND_TLS_CERT_PATH。
  • OpenNode:OPENNODE_API_KEY,仅支持开票/直接支付,无法支付 L402。

支出限制

限制位于 ~/.lightning-enable/config.json,运行时只读——智能体只能收紧自己的上限,不能提高。可以美元、satoshi 或同时设置。当同时设置两种计价单位时,每次检查以更严格的上限为准。价格源中断时,satoshi 上限仍能限制支出;若设置了 autoApproveSats,则等于或低于该值的支付自动批准,高于则需确认;若未设置,则所有支付都需要确认,直到价格源恢复。

工具清单

共 17 个工具:14 个免费(仅需钱包)和 3 个需要 LIGHTNING_ENABLE_API_KEY(Agentic Commerce 订阅)。其中 5 个是动作工具,通过 action 参数选择操作。旧工具名仍可调用,但在 v3.0.0 中已弃用。工具配置文件(LIGHTNING_ENABLE_TOOL_PROFILE)控制向模型上下文推送的 schema 数量,但不移除能力。

适用场景

  • AI 智能体需要自动支付比特币发票或访问 L402 付费 API。
  • 开发者希望将自己的 API 通过 L402 按次收费并出售给智能体。
  • 智能体之间在 Nostr 上进行服务发现、请求、结算和评价。
  • 需要为智能体支付设置预算控制和人工确认的安全场景。

限制

  • L402 支付需要返回原像的钱包,OpenNode 不支持。
  • 生产者工具和 ASA 工具需要 Agentic Commerce 订阅($49/月,30 天免费试用),或通过 create_lightning_enable_account 支付约 100 sats 激活。
  • 人工确认码机制仅作为操作员确认辅助,在托管服务器上需自行选择确认渠道(控制台、文件或 webhook),且不构成独立审批边界。
  • 托管 Lightning Enable API 上,agent_services 的 attest 操作被拒绝,无法通过其留下评价。
  • 完整工具文档和 Python README 可参考仓库内文档。