MCP

🚀 Alby比特幣支付MCP服務器

本項目可通過Nostr錢包連接（NWC）將比特幣閃電網絡錢包與你的大語言模型（LLM）相連接。

此MCP服務器採用了官方MCP TypeScript SDK 。

藉助Alby SDK 和Alby閃電網絡工具，該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 Desktop

使用遠程Alby MCP服務器

目前，至少需要Claude Pro訂閱才能連接到遠程MCP服務器。

1. 轉到設置 -> 集成
2. 點擊“添加集成”
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. 轉到設置 -> 高級設置
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服務器正常運行。