🚀 Alby比特币支付MCP服务器
本项目可通过Nostr Wallet Connect（NWC）将比特币闪电钱包连接到你的大语言模型（LLM）。
此MCP服务器使用了官方MCP TypeScript SDK。
借助Alby SDK和Alby Lightning Tools，该MCP服务器支持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（请参阅上述说明）
客户端
将以下内容添加到你的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](https://github.com/nerding - io/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服务器正常工作。