MCP

🚀 Alby Bitcoin Payments MCP Server

Nostr Wallet Connect (NWC)を使用して、Bitcoin Lightningウォレットを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://..."

SSEを介してN8Nに追加する

AIエージェントに接続されたネイティブのN8N MCPクライアントツールを使用できます。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エージェントノードを追加します。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

以下の環境変数を設定することで、Streamable HTTP (http://localhost:3000/mcp) とSSE (http://localhost:3000/sse 注意: SSEは非推奨) を有効にできます。

MODE=HTTP

HTTPではBearer認証が必要で、トークンはウォレットのNWC接続シークレットです。READMEの認証セクションを参照してください。

ソースからのセットアップ

前提条件

• Node.js 20+
• Yarn
• NWCをサポートするLightningウォレットの接続文字列

インストール

yarn install

ビルド

yarn build

NWC接続を追加する

.env.example を .env にコピーし、接続文字列を更新します。

ツールを確認する（LLMなしで使用/テストする）

yarn inspect

サポートされているツール

ツールディレクトリ を参照してください。

トラブルシューティング

モデルの使用

適切なモデル（例：Claude Sonnet 3.7）を使用するようにしてください。そうしないと、MCPサーバーが正常に動作しません。

ウォレットへの接続失敗、シークレットが不足している

NWC接続シークレット全体をスペースなしでコピーしたことを確認してください。

Albyサポートに問い合わせる

support.getalby.com にアクセスして、MCPサーバーを正常に動作させるためのサポートを受けることができます。