🚀 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服务器。
- 转到设置 -> 集成
- 点击“添加集成”
- 将其命名为
alby - 端点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桌面版
- 打开Goose桌面版
- 转到设置 -> 高级设置
- 点击“添加自定义扩展”
- 将其命名为
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://..."
通过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服务器
- 下载并打开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，并更新您的连接字符串
检查工具（在不使用大语言模型的情况下使用/测试）
yarn inspect
支持的工具
请参阅 工具目录
🛠️ 故障排除
模型使用
请确保您使用的是合适的模型（例如Claude Sonnet 3.7），否则MCP服务器将无法正常工作。
无法连接到钱包，缺少密钥
请确保您复制了完整的NWC连接密钥，且没有空格。
联系Alby支持
访问 support.getalby.com，我们将竭诚为您提供帮助，确保MCP服务器正常运行。