LNbits MCP Server 是一个面向 LNbits 的 MCP（Model Context Protocol）服务器，用于把 AI 助手接入 Lightning 钱包。它由 LNbits 团队开发，目标是让任何兼容 MCP 的 AI 客户端直接连接你的 LNbits 实例，通过自然语言完成钱包操作。
用途 MCP 是一种开放标准，允许 AI 助手使用外部工具。该服务器的作用是让 AI 直接访问你的 LNbits 钱包，而不是把 API 响应复制粘贴到聊天中。你自然说话，AI 调用正确的 API 端点，结果在同一段对话中返回。
主要能力
- 钱包操作：查询余额、查看交易历史、获取钱包详情。
- 发送与接收：支付 Lightning 发票、支付 Lightning 地址、创建发票。
- 扩展支持：LNURLp、TPoS、SatsPay、只读钱包（Watch-only wallets）。
- 管理员工具：节点信息、用户管理、系统统计。
- 运行时配置：通过聊天配置 LNbits 连接，无需环境变量文件。
- 安全：API 密钥仅存储在内存中，从不记录日志；生产环境建议使用 HTTPS。
- 限流：内置请求节流，防止意外的大量 API 请求。
使用方式 官方给出的步骤约需两分钟，需要 Python 3.10+。
- 安装：在仓库目录运行 pip install -e .，并确认 lnbits-mcp-server 命令可用。
- 添加到 AI 客户端：以 Claude Desktop 为例，编辑配置文件。macOS 路径为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 路径为 %APPDATA%\Claude\claude_desktop_config.json。保存后重启 Claude Desktop，服务器仅在重启后激活。
- 连接 LNbits：直接用自然语言告诉 AI 你的凭据，无需额外配置文件。之后可以问“我的钱包余额是多少？”来确认是否可用。 API 密钥位置：打开 LNbits 实例，在侧边栏“Node URL, API keys and API docs”下查看。需要发送支付时使用 Admin key，仅需查询余额和创建发票时使用 Invoice key。 可以自然对话，AI 会自行判断调用哪个工具；也可以串联请求，例如“创建一张 5000 sat 的发票并显示二维码”或“检查上一笔支付是否成功，如果成功，我的新余额是多少？”。 支付 Lightning 地址时可直接说“发送 1000 sats 到 user@domain.com”，无需先创建发票。
配置参考 大多数用户使用运行时配置即可。也支持环境变量方式，至少需要一种认证方式；多数场景下 LNBITS_API_KEY 配合 api_key_header 即可。服务器通常由 AI 客户端自动启动，也可手动运行以便测试或调试连接问题，或通过环境变量设置凭据，适用于在 AI 客户端之外测试、在 Docker 中运行或集成到脚本中。
适用场景 适合希望通过自然语言管理 LNbits Lightning 钱包的用户，包括查询余额与交易、创建与支付发票、支付 Lightning 地址、管理 LNbits 扩展，以及在具备管理员密钥时进行节点与用户管理。
限制与注意事项
- 需要 Python 3.10+，并需从仓库目录执行 pip install -e .。
- 修改配置文件后必须重启 AI 客户端，服务器才会激活。
- Invoice key 只能创建发票和查询余额，发送支付需使用 Admin key。
- 发送支付前需确认 LNbits 钱包余额充足。
- 支付 Lightning 地址时，收款方服务器必须可达。
- 远程实例应使用 https://。
- 管理员工具仅在以 Super User 或管理员级 API 密钥连接时可用；扩展工具仅在 LNbits 实例安装了对应扩展时出现。
- 运行时配置每个会话只需配置一次，服务器会记住设置直到重启。
项目为开源，欢迎通过 fork 仓库、创建功能分支、修改并添加测试、提交 pull request 的方式贡献。
