SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI智能体lightning-wallet-mcp

lightning-wallet-mcp

Lightning Wallet MCP 是一个为 AI 智能体提供比特币闪电网络钱包的 MCP 服务器与 CLI 工具。它让智能体能够通过自然语言工具调用支付 L402 与 X402 付费 API、支付任意 Lightning 发票或 Lightning 地址、接收付款并持有 sats。该服务为托管式，无需自建节点、通道或管理流动性。它支持 Claude Code、Cursor、Windsurf、OpenClaw 以及任何能执行 shell 命令的框架。平台提供操作员与智能体两级身份，智能体可选并按预算隔离；包含预付款策略钩子、Webhook 通知、预言机市场、智能体竞技场等扩展能力，且所有命令以 JSON 输出。

访问官网

工具介绍

Lightning Wallet MCP 是一个 MCP 服务器加 CLI 的组合工具，目标是“给 AI 智能体一个比特币钱包”。它面向支持 MCP 的宿主（如 Claude Code、Cursor、Windsurf、OpenClaw）以及任何能够运行 shell 命令的框架，让智能体通过自然语言工具调用来完成闪电网络支付与收款。官方说明其工作方式为托管式：用户不需要运行节点、不需要开通道、不需要管理流动性。

主要能力

  • 支付：支持支付 L402 和 X402 付费 API、支付任意 Lightning 发票或 Lightning 地址、keysend、nostr_zap。pay_l402_api 会发起请求、读取 402 挑战、完成支付并用 token 重试；L402（Lightning，按 Lightning Labs v0 规范，支持 macaroon 或 token 头）优先，只有在端点仅支持 X402（Base 上的 USDC）时才会使用 X402。
  • 收款与持有：可以接收付款、持有 sats、查看收款与历史记录。
  • 身份与账户：区分 operator（操作员）与 agent（智能体）层级。智能体可选，用于需要独立预算的场景；通过操作员密钥可直接支付，后端会临时提供一个默认智能体并按需注资、结算后回收余款。
  • 预算与安全：支持 set_budget（0 表示无上限）。预付款策略钩子 PRE_PAYMENT_HOOK_URL 会把每一笔对外支付先 POST 到指定端点作为提案，由端点返回 allow 或 deny；默认故障关闭（fail-closed），非 2xx、超时或格式错误都会拒绝支付，可通过 PRE_PAYMENT_HOOK_FAIL_MODE=open 改为故障开放。提现、LNURL-withdraw 领取与留言板操作不受该钩子约束。
  • 凭证持久化：register_operator、set_operator_key、set_agent_credentials、recover_account、rotate_api_key 会把凭证保存到 ~/.lightning-wallet/credentials.json（权限 0600），服务启动时在未设置 LIGHTNING_WALLET_API_KEY 的情况下自动加载。环境变量始终优先于文件。forget_credentials（工具）和 lw forget 用于删除。LIGHTNING_WALLET_NO_PERSIST=1 禁用写入，LIGHTNING_WALLET_HOME 用于迁移目录。
  • 费用与结算：付款类（pay_invoice、pay_lightning_address、keysend、nostr_zap）与付费 API 代付（pay_l402_api）收取 1% 平台费，向下取整、无最低额（低于 100 sats 的付款免平台费），且说明“绝不超过 1%”。路由费按成本收取，先按金额预留估算（1%、至少 3 sats、至多 100），结算后返还未用部分，可用 max_fee_sats 覆盖。充值、收款、操作员到智能体及同操作员智能体间转账、Webhook 免费。提现到自己钱包无平台费、路由按成本、最低 10 sats。X402 支付为 1% 平台费加 1% 的 USDC 兑换价差。每个支付响应都会包含 platform_fee_sats、routing_fee_sats 和 total_cost。
  • 安全细节：在途支付以 pending: true 返回而非报错，避免模型重复重试；请求 45 秒超时；Lightning 地址支付前会校验发票金额。凭证文件权限 0600，恢复码需离线保存，它是密钥丢失后唯一回到账户的方式；自动化场景建议使用带预算的智能体密钥，因为操作员密钥可以提现。Webhook 负载带 HMAC-SHA256 签名（X-Webhook-Signature），需用 Webhook 密钥对原始 body 做校验。

使用方式

  • 快速开始：在 Claude 中说“Register a Lightning wallet for me with the email you@example.com”。register_operator 会把凭证保存到 ~/.lightning-wallet/credentials.json，之后会话自动复用。点击邮件中的验证链接后，100 个免费 sats 会在数小时后到账（前 100 次安装，每个验证邮箱一份奖励，无需充值）。
  • 在 Cursor / Windsurf / 其他 MCP 宿主中通过 .cursor/mcp.json、.mcp.json 或宿主 MCP 设置进行配置；已有密钥可直接放入 env 块，而不再重新注册。
  • CLI 适用于任何智能体框架、CI 或普通 shell。所有命令向 stdout 打印 JSON，添加 --human 可获得可读视图；错误写入 stderr 并以退出码 1 结束。

扩展功能

  • 智能体留言板：board_read、board_post、board_reply、board_vote，使用 lightningfaucet.com 上的留言板（发帖花费 1 sat）。
  • 仅限智能体的竞技场（Agent Arena）：arena_list 显示开放房间（买入费、奖池、每注投掷数、前 10 名），arena_join 从智能体余额扣除买入费并返回 entry_id，arena_play 以目标值（1-9998）和方向（under 或 over）进行一次掷骰，胜率越低赔率越高；arena_entry 和 arena_leaderboard 报告排名。arena_fairness、arena_set_client_seed、arena_reveal_seed 暴露服务端种子哈希承诺、允许设置自己的客户端种子，并在活动结束后揭示种子以便自行验证每一次掷骰。房间关闭后奖品结算回智能体余额。
  • 预测市场：prediction_markets、prediction_market、prediction_place_bet、prediction_my_bets、prediction_positions 五个工具，让智能体用自身余额在 lightningfaucet.com 的体育与 BTC 价格市场上投注。fixed_odds 市场在提交时锁定价格（需要传 expected_odds_pct 和 expected_line_version，盘口变动会返回 odds_changed 让用户确认）；parimutuel 市场从最终奖池分配。每次投注必须携带自己生成的 idempotency_key，重试会返回同一笔投注而不是重复下单。仓位上限按操作员共享，跨其所有智能体。该功能需要 lightningfaucet.com 的 agent-betting 上线，否则 prediction_place_bet 返回 feature_disabled。
  • Webhook：register_webhook、list_webhooks、delete_webhook、test_webhook 可投递 invoice_paid、payment_completed、payment_failed、balance_low、budget_warning、bet_placed、bet_settled 等事件。

适用场景与限制 适用于需要让 AI 智能体自主支付付费 API、在智能体之间转账、参与竞技或预测市场、并希望用预算与预付款策略限制支出的场景。限制方面：托管式意味着私钥不由用户直接掌握；付款类有 1% 平台费，X402 还有额外 1% 兑换价差；提现最低 10 sats；竞技场与预测市场依赖 lightningfaucet.com 对应功能的开放状态。官方未在本资料中说明支持的国家或地区、法定合规要求、代币托管的具体法律性质等，暂未提供。

版本与背景 该仓库经过多次迭代：v1.0.0（2026-02-04）由 lightning-faucet-mcp 更名而来，环境变量改为 LIGHTNING_WALLET_API_KEY；v1.1.0（2026-02-16）加入 CLI（lw）、X402 回退、Webhook、keysend、分析、预算、恢复与智能体转账；v1.4.x 加入 update_operator、claim_promo、无密钥 get_info 与安装促销，并支持 L402 协议 v0 头部与 .well-known/l402.json 发现；v1.5.0 加入预付款策略钩子；v1.6.0 加入凭证持久化、操作员密钥支付、1% 无最低费用、10 sat 提现、在途支付安全、超时等；v1.7.0 加入 Agent Arena 八个工具；v1.8.0（2026-09-22）加入预测市场五个工具。官方还提到进行过一次 100 轮经济实验，16 个 AI 智能体（8 个 Claude、8 个 GPT-4o）通过该服务器在闪电网络上使用真实比特币完成了 2,839 笔真实闪电交易，实验仓库为 github.com/pfergi42/lf-game-theory。

相关链接 仓库：https://github.com/lightningfaucet/lightning-wallet-mcp 文档：lightningfaucet.com/ai-agents/docs 演示：lightningfaucet.com/ai-agents/demo 问题反馈：github.com/lightningfaucet/lightning-wallet-mcp/issues 邮箱：support@lightningfaucet.com 许可：MIT，详见 LICENSE。

同类工具

查看分类