Alby Bitcoin Payments MCP

Alby Bitcoin Payments MCP Server

**新功能：**不支持 MCP 的 Agent 也可以试试 Alby CLI。

使用 Nostr Wallet Connect（NWC）将比特币闪电钱包连接到你的大模型。

此 MCP 服务使用 官方 MCP TypeScript SDK。

此 MCP 服务通过 Alby SDK 和 Alby Lightning Tools，支持 NWC、LNURL 和 L402。

前往 Awesome AI Bitcoin，了解可以使用 Alby MCP 的地方。

快速开始

如果遇到问题，请参阅下方的故障排除部分。

使用 Alby 托管的 MCP 服务

如果你的 Agent 支持远程 MCP 服务——SSE（例如 N8N）或 HTTP Streamable 传输方式，则可以连接到 Alby 的 MCP 服务。

• SSE：https://mcp.getalby.com/sse
• HTTP Streamable：https://mcp.getalby.com/mcp

身份验证

两种方式都需要提供 NWC 连接密钥进行身份验证，可使用 Bearer 身份验证（推荐）或 nwc 查询参数。

Bearer 身份验证

示例：Authorization: Bearer nostr+walletconnect://...

如果你的 Agent 界面支持 Bearer 身份验证，只需将连接密钥粘贴到 Bearer 身份验证字段中。

查询参数

如果你的 Agent 不支持 Bearer 身份验证，可以将 NWC 连接密钥作为查询参数传递。

示例：https://mcp.getalby.com/sse?nwc=ENCODED_CONNECTION_SECRET 或 https://mcp.getalby.com/mcp?nwc=ENCODED_CONNECTION_SECRET

要获取 ENCODED_CONNECTION_SECRET，请打开浏览器开发者工具（右键 -> 检查），并在控制台中输入以下内容，同时设置你自己的 NWC 连接密钥：

encodeURIComponent("nostr+walletconnect://...");

如果出现要求确认粘贴内容的消息，请按提示操作，然后再次输入上述命令。

命令运行后，复制输出并替换 ENCODED_CONNECTION_SECRET。结果看起来会像这样：nostr%2Bwalletconnect%3A%2F%2F...

添加到 Claude Web 或 Claude Desktop

使用远程 Alby MCP 服务

目前，至少需要订阅 Claude Pro 才能连接远程 MCP 服务。

1. 前往 Settings -> Connectors
2. 点击 "Add custom connector"
3. 将其命名为 alby
4. 输入端点 URI：https://mcp.getalby.com/mcp?nwc=ENCODED_NWC_URL（操作说明见上文）

客户端

将以下内容添加到你的 claude_desktop_config.json：

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

添加到 Goose Desktop

1. 打开 Goose Desktop
2. 前往 Settings -> Advanced Settings
3. 点击 "Add custom Extension"
4. 将其命名为 alby，并将类型更改为 HTTP Streamable
5. 输入 SSE 端点 URI：https://mcp.getalby.com/mcp
6. 超时：30
7. 描述：否
8. 环境变量：否

添加到 Goose CLI

使用 Alby MCP 服务

1. 输入 goose configure
2. Add extension -> Remote Extension (HTTP Streamable)
3. 将其命名为 alby
4. 输入 HTTP Streamable 端点 URI：https://mcp.getalby.com/mcp
5. 超时：30
6. 描述：否
7. 环境变量：否
8. 添加自定义标头：是
9. 标头名称：Authorization
10. 标头值：Bearer nostr+walletconnect://...（替换为你的连接密钥）

客户端

1. 输入 goose configure
2. Add extension -> Command Line Extension
3. 将其命名为 alby
4. 要运行的命令：npx -y @getalby/mcp
5. 超时：30
6. 描述：否
7. 环境变量：是
8. 环境变量名称：NWC_CONNECTION_STRING
9. 环境变量值：nostr+walletconnect://...（在此填入你的 NWC 连接密钥）

添加到 Cline

复制以下内容并粘贴到 Cline 提示词中。它会提示你更新连接字符串。

Add the following to my MCP servers list:

"nwc": {
  "command": "npx",
  "args": ["-y", "@getalby/mcp"],
  "env": {
    "NWC_CONNECTION_STRING": "nostr+walletconnect://..."
  },
  "disabled": false,
  "autoApprove": []
}

添加到 Claude Code

使用 Alby MCP 服务

claude mcp add --transport http alby https://mcp.getalby.com/mcp --header "Authorization: Bearer nostr+walletconnect://..."

通过 SSE 添加到 N8N

你可以使用连接到 AI Agent 的原生 N8N MCP 客户端工具。输入 SSE 端点，将身份验证设为「Bearer」，然后粘贴你的 NWC 连接密钥。

已使用 OpenRouter + anthropic/claude-3.7-sonnet 测试

请参阅 N8N 工作流 查看简单示例

通过 STDIO 添加到 N8N（社区节点）

目前，此 MCP 服务仅支持通过命令行（STDIO）运行。

你可以安装 n8n-nodes-mcp 社区节点，并在启用工具的情况下运行 n8n，例如：

N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true npx n8n

创建一个空白工作流并添加 AI Agent 节点。配置你的大模型，并添加一个新工具「MCP Client」（旁边会显示一个立方体，表示它是社区节点）。

通过添加凭据来配置 MCP Client，并选择 Command Line (STDIO)。

命令：npx 参数：-y @getalby/mcp 环境变量 NWC_CONNECTION_STRING=nostr+walletconnect://your_key_here（在文本编辑器中创建整行后粘贴，因为密码字段无法切换为明文）

请参阅 N8N 付费聊天工作流 查看完整示例

添加到 Windsurf

使用 Alby 远程 MCP 服务

1. 下载并打开 Windsurf Editor
2. 点击底部工具栏中的「Windsurf - Settings」->「Advanced Settings」->「Cascade」-> Plugins (MCP Servers)：点击「Manage plugins」->「View raw config」-> 你会看到「mcp_config.json」
3. 将以下内容粘贴到 mcp_config.json 中：

{
  "mcpServers": {
    "alby": {
      "serverUrl": "https://mcp.getalby.com/sse?nwc=ENCODED_NWC_URL"
    }
  }
}

4. 按上述说明替换「ENCODED_NWC_URL」。点击「Save」并重启 Windsurf Editor。

模式

STDIO

默认情况下，NWC MCP Server 在本地以 STDIO 模式运行。

HTTP

你可以设置以下环境变量：MODE=HTTP，以启用 Streamable HTTP（http://localhost:3000/mcp）和 SSE（http://localhost:3000/sse。注意：SSE 已弃用）。

HTTP 需要 Bearer 身份验证，令牌为钱包的 NWC 连接密钥。请参阅 README 上文的身份验证部分。

请求验证

HTTP 端点仅接受 Host 标头值在允许列表中的请求。来自浏览器的请求（带有 Origin 标头）会被拒绝；非浏览器的 MCP 客户端不会发送该标头。fetch_l402 仅获取主机名解析到全局可路由地址的 http(s) URL——环回、链路本地和私有地址范围会被拒绝。这是尽力而为的检查：获取时会再次解析主机名，因此，如果 DNS 服务器在两次查询之间更改响应，就可能绕过此检查。通过环境变量配置：

变量	默认值	用途
ALLOWED_HOSTS	localhost、127.0.0.1、[::1]	要接受的 Host 标头值（以逗号分隔）。设置后，它会替换默认值，因此如果仍希望允许 localhost，请将其包含在内。部署时将其设为你的公共主机名（例如 mcp.getalby.com）。
BIND_HOST	127.0.0.1	HTTP 监听器绑定的地址。默认值会阻止其接入网络；部署时或在 Docker 中运行并从主机连接时，将其设为 ::（或 0.0.0.0）。

fetch_l402 不会跟随重定向；遇到重定向的 URL 会返回错误。

从源代码构建

先决条件

• Node.js 20+
• Yarn
• 支持 NWC 的闪电钱包连接字符串

安装

yarn install

构建

yarn build

添加 NWC 连接

将 .env.example 复制为 .env 并更新连接字符串

检查工具（无需大模型即可使用/测试）

yarn inspect

支持的工具

请参阅 tools 目录

故障排除

模型使用

请确保使用性能足够好的模型（例如 Claude Sonnet 3.7），否则 MCP 服务将无法运行。

无法连接到钱包，缺少密钥

请确保复制了完整的 NWC 连接密钥，且不含空格

联系 Alby 支持团队

请访问 support.getalby.com，我们很乐意帮您让 MCP 服务正常运行。