MCP

🚀 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服務器。

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桌面版

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](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服務器

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並更新你的連接字符串

檢查工具（在不使用LLM的情況下使用/測試）

yarn inspect

支持的工具

請參閱工具目錄

🔧 故障排除

模型使用

確保你使用的是合適的模型（如Claude Sonnet 3.7），否則MCP服務器將無法工作。

無法連接到錢包，缺少密鑰

確保你複製了完整的NWC連接密鑰，且沒有空格。

聯繫Alby支持

訪問support.getalby.com，我們將很樂意幫助你使MCP服務器正常工作。