MCP服务器

Name: MCP服务器
Author: getAlby

作者：getAlby36 星标更新：2025-07-16

安装使用来源：spider==github.com

项目介绍

Alby Bitcoin Payments MCP Server

通过Nostr Wallet Connect（NWC）将比特币闪电钱包连接到您的大型语言模型（LLM）。

此MCP服务器使用了官方的MCP TypeScript SDK。

此MCP服务器具备对NWC、LNURL和L402的知识，使用了Alby SDK和Alby Lightning Tools。

快速开始

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

使用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://...

如果您的代理UI支持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 Desktop

使用远程Alby MCP服务器

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

前往设置 -> 集成
点击“添加集成”
称之为alby
端点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

打开Goose Desktop
前往设置 -> 高级设置
点击“添加自定义扩展”
称之为alby，并将类型更改为HTTP流传输
SSE端点URI是什么：https://mcp.getalby.com/mcp
超时：30
描述：否
环境变量：否

添加到Goose CLI

使用Alby MCP服务器

输入goose configure
添加扩展 -> 远程扩展（HTTP流传输）
称之为alby
HTTP流传输端点URI是什么：https://mcp.getalby.com/mcp
超时：30
描述：否
环境变量：否
添加自定义头：是
头名称：Authorization
头值：Bearer nostr+walletconnect://...（替换为您的连接密钥）

客户端

输入goose configure
添加扩展 -> 命令行扩展
称之为alby
应该运行什么命令：npx -y @getalby/mcp
超时：30
描述：否
环境变量：是
环境变量名称：NWC_CONNECTION_STRING
环境变量值：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://..."

添加到N8N通过SSE

您可以使用N8N自带的MCP客户端工具连接到AI代理。输入您的SSE端点，将认证设置为“Bearer”，并粘贴您的NWC连接密钥。

已测试与OpenRouter + anthropic/claude-3.7-sonnet兼容

查看N8N工作流程以获得简单示例

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

目前此MCP服务器仅可通过命令行(STDIO)使用。

您可以安装n8n-nodes-mcp社区节点，并启用工具运行n8n，例如：

N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true npx n8n

创建空白工作流并添加AI代理节点。配置您的LLM模型，并添加一个新的工具“MCP客户端”（旁边有一个立方图标，表示这是一个社区节点）。

通过添加一个选择了命令行(STDIO)的凭证来配置MCP客户端。

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

查看N8N付费聊天工作流以获得完整示例

添加到Windsurf

使用远程Alby MCP服务器

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

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

替换“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并更新您的连接字符串

检查工具（无需LLM使用/测试）

yarn inspect

支持的工具

查看工具目录

故障排除

模型使用

确保使用一个不错的模型（例如Claude Sonnet 3.7），否则MCP服务器将无法正常工作。

无法连接到钱包，密钥丢失

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

联系Alby支持

访问support.getalby.com，我们很高兴帮助您让MCP服务器正常工作。