lnbits/LNbits-MCP-服务器

完整文档

2. 添加到您的 AI 客户端

告知您的 MCP 客户端服务器的位置。对于 Claude Desktop，请编辑配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "lnbits": {
      "command": "lnbits-mcp-server"
    }
  }
}

3. 连接到你的 LNbits

现在直接与你的 AI 对话即可。无需额外的配置文件 —— 用自然语言告诉它你的凭据：

Configure lnbits.

URL: https://your-lnbits-instance.com
Key: your_api_key_here
Auth method: api_key_header

> 我的 API key 在哪里？ 打开你的 LNbits 实例，在侧边栏的 "Node URL, API keys and API docs" 下查看。如果你需要发送付款，请使用 Admin key；如果你只需要检查余额和创建发票，请使用 Invoice key。

你可以这样说

直接自然地交谈即可。AI 会自动判断调用哪个 tool。

"Check my wallet balance"
"Create an invoice for 1000 sats with memo 'Coffee payment'"
"Pay this invoice: lnbc10u1p3..."
"Send 500 sats to [email protected]"
"Show me my recent payments"
"Decode this invoice and tell me what it's for"

Available Tools

这些是 AI 在后台使用的工具。您不需要直接调用它们 —— 只需描述您的需求，AI 会选择合适的工具。

Configuration

| Tool | Description |
|---|---|
| configure_lnbits | 在运行时设置 LNbits URL、API key 和 auth method |
| get_lnbits_configuration | 显示当前的连接设置 |
| test_lnbits_configuration | 验证连接是否正常 |

> 每个会话只需配置一次。服务器会记住您的设置，直到重启为止。

Wallet

| Tool | Description |
|---|---|
| get_wallet_details | 钱包信息，包括余额和 keys |
| get_wallet_balance | 当前余额 |
| get_payments | 付款历史 |
| check_connection | 测试与 LNbits 的连接 |

Payments

| Tool | Description |
|---|---|
| pay_invoice | 支付 BOLT11 Lightning invoice |
| pay_lightning_address | 支付 Lightning address ([email protected]) |
| get_payment_status | 通过 payment hash 检查状态 |
| decode_invoice | 解码并检查 Lightning invoice |
| create_invoice | 创建新的 Lightning invoice |

> 提示： 您可以直接支付 Lightning addresses —— 只需说 “发送 1000 sats 到 [email protected]”。无需先创建 invoice。

Extensions (when enabled)当你在 LNbits 实例上安装了相应的扩展时，这些工具会出现。

| 工具 | 描述 |
|---|---|
| create_lnurlp_link / get_lnurlp_links | LNURLp 支付链接 |
| create_tpos / get_tpos_list | TPoS 终端 |
| create_satspay_charge / get_satspay_charges | SatsPay 费用 |
| create_watchonly_wallet / get_watchonly_wallets | 只读钱包 (Watch-only wallets) |

Admin (需要 admin key)

仅当你使用 Super User 或管理员级 API key 连接时可用。

| 工具 | 描述 |
|---|---|
| get_node_info | Lightning 节点信息 |
| list_users / create_user | 用户管理 |
| get_system_stats | 系统统计数据 |

配置参考

大多数人直接使用运行时配置（上述步骤 3）。但如果你更倾向于使用环境变量，以下配置同样有效：

| 变量 | 描述 | 默认值 |
|---|---|---|
| LNBITS_URL | LNbits 实例 URL | https://demo.lnbits.com |
| LNBITS_API_KEY | API key | - |
| LNBITS_BEARER_TOKEN | Bearer token (备选认证方式) | - |
| LNBITS_OAUTH2_TOKEN | OAuth2 token (备选认证方式) | - |
| LNBITS_AUTH_METHOD | api_key_header, api_key_query, http_bearer, 或 oauth2 | api_key_header |
| LNBITS_TIMEOUT | 请求超时时间 (秒) | 30 |
| LNBITS_MAX_RETRIES | 失败后的最大重试次数 | 3 |
| LNBITS_RATE_LIMIT_PER_MINUTE | 速率限制 | 60 |

> 至少需要一种认证方式。对于大多数设置，只需 LNBITS_API_KEY 配合 api_key_header 即可。## 手动运行服务器

你的 AI 客户端通常会自动启动服务器。但如果你想直接进行测试或调试连接问题，可以手动运行它：

# Using the installed command
lnbits-mcp-server

Or run directly with Python
python -m lnbits_mcp_server.server

export LNBITS_URL="https://your-lnbits-instance.com"
export LNBITS_API_KEY="your_api_key_here"
lnbits-mcp-server

故障排除

服务器无法启动

• 检查是否安装了 Python 3.10+：python3 --version

• 确保你在 repo 目录下运行了 pip install -e .

• 验证 lnbits-mcp-server 命令是否可用：which lnbits-mcp-server

配置后连接失败

• 验证你的 LNbits 实例正在运行且可以通过你的机器访问

• 仔细检查 API key —— Admin key 和 Invoice key 是不同的

• 确保远程实例使用的是 https://

AI 客户端不显示 LNbits 工具

• 编辑配置文件后请重启你的 AI 客户端

• 检查 claude_desktop_config.json 中的路径是否正确

• 查看客户端日志以确认 MCP 连接错误

支付失败

• Invoice key 只能创建发票和检查余额 —— 发送支付请使用 Admin key

• 检查你的 LNbits 钱包是否有足够余额

• 对于 Lightning address 支付，接收方的服务器必须可访问

开发

bash

git clone https://github.com/lnbits/LNbits-MCP-Server.git