← 返回目录

Alby Bitcoin Payments MCP Server

官方

通过 Nostr Wallet Connect 把比特币闪电网络钱包接入你的 LLM

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 88 / 230
Stars: ★ 66 热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Node.js 20+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 9 天前

58FMRS · C

由 Alby 官方维护并提供托管服务的比特币闪电网络 MCP 服务器，支持本地 STDIO 与远程 SSE/HTTP Streamable 两种接入方式，核心风险在于 NWC 连接密钥的保管与传输安全。

最强项 · 文档质量 16/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

8/20

维护活跃度

13/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 7/20: README 描述了 STDIO 与 HTTP 两种运行模式，并提到可用 `yarn inspect` 在无 LLM 情况下测试工具，工具清单指向 src/tools 目录，但本次评审未获得该目录内容、manifest、package.json 或任何 CI/测试文件的证据。没有可验证的自动化测试或 CI 工作流来证明声明的工具行为与实际行为一致，也无法确认初始化/工具列表握手在各种边缘情况下的健壮性，因此依据静态评审规则将分数压低（不超过12分）。
安全与权限 8/20: 该服务器需要用户提供 NWC 钱包连接密钥（通过环境变量、Bearer 认证或 URL 查询参数），密钥直接授予对比特币闪电钱包的访问权限。README 中未说明支付类工具在执行前是否有确认步骤、限额提示或最小权限范围的说明；同时官方文档中明确提供了将密钥作为 URL 查询参数传递的方式，这种模式容易通过服务器日志、浏览器历史或代理缓存造成密钥泄露，属于不良实践。安装示例中未包含真实密钥（均为占位符），也没有证据表明存在恶意代码或隐蔽的数据外泄，因此不构成红线情形，但风险披露与权限确认机制不完整，故适度扣分。
维护活跃度 13/20: 仓库采用 Apache-2.0 许可证，未被归档，有 67 星、7 个未解决 issue，README 提供了官方支持渠道（support.getalby.com）。但所提供材料中没有关于发布节奏、最近提交记录或依赖更新策略的直接证据，无法验证维护活跃度的具体细节，因此扣分但不视为废弃项目。
文档质量 16/20: 文档覆盖面广，包含面向多种客户端（Claude Desktop、Claude Code、Goose、Cline、N8N、Windsurf 等）的详细安装步骤、认证方式说明（Bearer 与查询参数两种）、运行模式说明、从源码构建步骤及故障排除章节。不足之处在于工具参数细节仅通过链接指向 src/tools 目录而非直接在 README 内联文档化，且未提及费用、速率限制或错误处理的具体说明，因此未给满分。
安装易用性 14/20: 提供多条清晰的安装路径：一行 npx 命令加环境变量即可在本地使用，也可直接连接 Alby 托管的远程 MCP 服务器而无需本地安装，覆盖了主流客户端的配置示例，入门门槛较低。但由于静态评审规则要求在缺乏可验证的 CI 与测试证据时上限为15分，且部分步骤（如浏览器控制台手动编码密钥）略显繁琐，因此未给最高分。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

已经拥有支持 NWC 的闪电钱包、需要让 LLM 代其操作资金的用户
希望在 Claude、Goose、Cline、Windsurf 等支持 MCP 的客户端中集成比特币支付能力的开发者

不适合谁

不使用比特币闪电网络或没有 NWC 钱包的用户
需要强模型推理能力之外的普通模型（README 明确提示需要较强模型，如 Claude 3.7 Sonnet，否则可能无法正常工作）

所需权限

需要提供 NWC 连接字符串，等同于授予该服务器操作你钱包资金的权限
远程托管模式下，需要将该密钥以 Bearer 或 URL 参数形式传输给 Alby 服务器

风险与副作用

NWC 连接字符串一旦泄露，任何持有者都可能操控关联钱包的资金
使用 URL 查询参数传递密钥时，密钥可能被记录在浏览器历史、日志或代理服务器中
依赖较弱的模型可能导致意外或错误的支付操作

安装接入

准备工作

运行环境：Node.js 20+ · 远程托管（无需本地环境）

NWC_CONNECTION_STRING 必填密钥 Nostr Wallet Connect 连接密钥（nostr+walletconnect://...），从支持 NWC 的闪电钱包（如 Alby）获取。

其他可选配置项（1 个）

MODE 可选运行模式变量，设为 HTTP 时启用 Streamable HTTP 与 SSE 本地端点；默认 STDIO 模式无需设置。

本地方式：安装 Node.js 20+，通过 npx 运行 @getalby/mcp 包，并在环境变量 NWC_CONNECTION_STRING 中填入你的 NWC 连接字符串（可从源码构建时先运行 yarn install / yarn build，并复制 .env.example 为 .env 填写连接串,用 yarn inspect 测试工具）。远程方式：直接连接 Alby 托管的端点 https://mcp.getalby.com/sse 或 https://mcp.getalby.com/mcp，并以 Bearer Token（即 NWC 连接字符串）或 URL 查询参数 nwc= 进行鉴权；不同客户端（Claude Desktop、Claude Code、Goose、Cline、Windsurf、N8N 等）的具体接入方式在 README 中均有示例配置。

claude_desktop_config.json

{
  "mcpServers": {
    "nwc": {
      "command": "npx",
      "args": [
        "-y",
        "@getalby/mcp"
      ],
      "env": {
        "NWC_CONNECTION_STRING": "YOUR NWC CONNECTION STRING HERE"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "nwc": {
      "command": "npx",
      "args": [
        "-y",
        "@getalby/mcp"
      ],
      "env": {
        "NWC_CONNECTION_STRING": "YOUR NWC CONNECTION STRING HERE"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add nwc -e 'NWC_CONNECTION_STRING=YOUR NWC CONNECTION STRING HERE' -- npx -y @getalby/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

连接后在客户端工具列表中确认 NWC 相关工具已出现，或直接询问“我的钱包余额是多少”，如返回钱包信息说明连接成功。

常见排障

确认使用了足够强的模型（如 Claude 3.7 Sonnet 等），否则服务器可能无法正常工作
检查是否完整复制了 NWC 连接字符串且不含多余空格，避免'连接钱包失败、密钥缺失'的报错
如仍有问题，可联系 support.getalby.com 获取官方支持

试试这样问

连接成功后，可以直接对 AI 助手这样说：

我的闪电钱包里现在有多少比特币？
向这个 LNURL 地址支付 100 聪。
帮我为这个 L402 发票生成付款。

使用场景

让 AI 代理直接发起或接收闪电网络付款

在自动化工作流（如 N8N）中加入按次付费或打赏环节

为不支持 MCP 的代理通过配套的 Alby CLI 实现类似能力

支持客户端

Claude Desktop

Claude Web部分支持

Claude Code

Goose Desktop

Goose CLI

Cline

Windsurf

N8N部分支持

依据项目文档列出，未经本站实测。

详细介绍

Alby MCP 服务器由 getAlby 官方维护，使用官方 MCP TypeScript SDK 构建，让 LLM 或代理通过 Nostr Wallet Connect（NWC）协议操作比特币闪电网络钱包。它内置对 NWC、LNURL 和 L402 协议的支持（基于 Alby SDK 与 Alby Lightning Tools），既可以在本地以 STDIO 方式运行，也可以连接 Alby 官方托管的远程服务（支持 SSE 和 HTTP Streamable 传输）。具体工具集合请查看仓库中的 src/tools 目录。