MCP

🚀 Alby比特币支付MCP服务器

本项目借助Nostr Wallet Connect（NWC），可将比特币闪电钱包连接到您的大语言模型（LLM）。该MCP服务器采用了 官方MCP TypeScript SDK，并且借助 Alby SDK 和 Alby Lightning Tools 实现了对 NWC、LNURL 和 L402 的支持。

🚀 快速开始

若您在使用过程中遇到问题，请查看下方的故障排除部分。

使用Alby托管的MCP服务器

如果您的代理支持远程MCP服务器 - SSE（例如N8N）或HTTP可流式传输协议，您可以连接到Alby的MCP服务器。

• SSE：https://mcp.getalby.com/sse
• HTTP可流式传输：https://mcp.getalby.com/mcp

身份验证

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

Bearer身份验证

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

如果您的代理用户界面支持Bearer身份验证，只需将连接密钥粘贴到Bearer身份验证字段即可。

查询参数

如果您的代理不支持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桌面版

使用远程Alby MCP服务器

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

1. 转到设置 -> 集成
2. 点击“添加集成”
3. 将其命名为alby
4. 端点URI：https://mcp.getalby.com/mcp?nwc=ENCODED_NWC_URL（请参考上述说明获取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桌面版

1. 打开Goose桌面版
2. 转到设置 -> 高级设置
3. 点击“添加自定义扩展”
4. 将其命名为alby，并将类型更改为HTTP可流式传输
5. SSE端点URI：https://mcp.getalby.com/mcp
6. 超时时间：30
7. 描述：无
8. 环境变量：无

添加到Goose CLI

使用Alby MCP服务器

1. 输入goose configure
2. 添加扩展 -> 远程扩展（HTTP可流式传输）
3. 将其命名为alby
4. HTTP可流式传输端点URI：https://mcp.getalby.com/mcp
5. 超时时间：30
6. 描述：无
7. 环境变量：无
8. 添加自定义标头：是
9. 标头名称：Authorization
10. 标头值：Bearer nostr+walletconnect://...（替换为您的连接密钥）

客户端

1. 输入goose configure
2. 添加扩展 -> 命令行扩展
3. 将其命名为alby
4. 要运行的命令：npx -y @getalby/mcp
5. 超时时间：30
6. 描述：无
7. 环境变量：是
8. 环境变量名称：NWC_CONNECTION_STRING
9. 环境变量值：nostr+walletconnect://...（此处填写您的NWC连接密钥）

添加到Cline

复制以下内容并粘贴到cline提示符中。系统将提示您更新连接字符串。

将以下内容添加到我的MCP服务器列表中：

"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

您可以使用原生N8N MCP客户端工具连接到AI代理。输入您的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代理节点。配置您的大语言模型，并添加一个新工具“MCP客户端”（旁边会有一个立方体图标，表示这是一个社区节点）。 通过选择命令行（STDIO）并添加凭证来配置MCP客户端。 命令：npx 参数：-y @getalby/mcp 环境变量：NWC_CONNECTION_STRING=nostr+walletconnect://your_key_here（在文本编辑器中创建整行内容并粘贴，因为密码字段无法切换为纯文本） 请参考 N8N付费聊天工作流 获取完整示例。

添加到Windsurf

使用远程Alby MCP服务器

1. 下载并打开Windsurf编辑器
2. 点击底部工具栏中的“Windsurf - 设置” -> “高级设置” -> “级联” -> 插件（MCP服务器）：点击“管理插件” -> “查看原始配置” -> 您将看到您的“mcp_config.json”文件
3. 将以下内容粘贴到您的mcp_config.json文件中：

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

4. 按照上述说明替换“ENCODED_NWC_URL”。点击“保存”并重启Windsurf编辑器。

📦 安装指南

模式

STDIO

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

HTTP

您可以设置以下环境变量：MODE=HTTP，这将启用可流式传输的HTTP（http://localhost:3000/mcp）和SSE（http://localhost:3000/sse 注意：SSE已弃用）。 HTTP需要Bearer授权，其中令牌是钱包的NWC连接密钥。请参阅README中前面的身份验证部分。

从源代码安装

前提条件

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

安装

yarn install

构建

yarn build

添加您的NWC连接

将.env.example复制到.env，并更新您的连接字符串

检查工具（在不使用大语言模型的情况下使用/测试）

yarn inspect

支持的工具

请参阅 工具目录

🛠️ 故障排除

模型使用

请确保您使用的是合适的模型（例如Claude Sonnet 3.7），否则MCP服务器将无法正常工作。

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

请确保您复制了完整的NWC连接密钥，且没有空格。

联系Alby支持

访问 support.getalby.com，我们将竭诚为您提供帮助，确保MCP服务器正常运行。