MCP

🚀 Alby Bitcoin Payments MCP Server

Nostr Wallet Connect (NWC) を使用して、ビットコインのライトニングウォレットをLLMに接続します。

このMCPサーバーは、公式のMCP TypeScript SDK を使用しています。

このMCPサーバーは、Alby SDK と Alby Lightning Tools を使用して、NWC、LNURL、L402 をサポートしています。

🚀 クイックスタート

困った場合は、以下のトラブルシューティングセクションを参照してください。

AlbyがホストするMCPサーバーを使用する

エージェントがリモートMCPサーバー - SSE（例：N8N）またはHTTP Streamableトランスポートをサポートしている場合、AlbyのMCPサーバーに接続できます。

• SSE: https://mcp.getalby.com/sse
• HTTP Streamable: 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サーバーを使用する

現在、リモートMCPサーバーに接続するには、少なくともClaude Proのサブスクリプションが必要です。

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 Streamable に変更します。
5. SSEエンドポイントURIは https://mcp.getalby.com/mcp です。
6. タイムアウト: 30
7. 説明: なし
8. 環境変数: なし

Goose CLIに追加する

Alby MCPサーバーを使用する

1. goose configure と入力します。
2. 拡張を追加 -> リモート拡張（HTTP Streamable）を選択します。
3. alby と名付けます。
4. HTTP Streamableエンドポイント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のプロンプトに貼り付けます。接続文字列の更新を求められます。

Add the following to my MCP servers list:

"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経由で追加する

AIエージェントに接続されたネイティブのN8N MCPクライアントツールを使用できます。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 Client" を追加します（コミュニティノードを示す立方体が隣に表示されます）。

MCPクライアントを設定するには、コマンドライン（STDIO）を選択して資格情報を追加します。

コマンド: 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 これにより、Streamable 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サーバーの動作をサポートします。