Alby MCP Server

Controle uma carteira Lightning usando Nostr Wallet Connect (NWC).

GitHub
66
Experimente este MCPPatrocinado

Documentação

Alby Bitcoin Payments MCP Server

NOVO: confira também o Alby CLI para agentes que não suportam MCP.

Conecte uma carteira bitcoin lightning ao seu LLM usando Nostr Wallet Connect (NWC).

Este servidor MCP usa o SDK oficial do MCP TypeScript

Este servidor MCP tem conhecimento de NWC, LNURL e L402 usando Alby SDK e Alby Lightning Tools.

Dê uma olhada em Awesome AI Bitcoin para lugares onde você pode usar o Alby MCP.

Início Rápido

Caso você fique preso, veja a seção de solução de problemas abaixo.

Use o servidor MCP hospedado pela Alby

Se o seu agente suporta servidores MCP remotos - SSE (por exemplo, N8N) ou transportes HTTP Streamable, você pode se conectar ao servidor MCP da Alby.

  • SSE: https://mcp.getalby.com/sse
  • HTTP Streamable: https://mcp.getalby.com/mcp

Autenticação

Ambos exigem fornecer um segredo de conexão NWC como autenticação, seja como autenticação Bearer (preferida) ou via parâmetro de consulta nwc.

Autenticação Bearer

Exemplo: Authorization: Bearer nostr+walletconnect://...

Se a interface do seu agente suporta autenticação bearer, basta colar o segredo de conexão no campo de autenticação bearer.

Parâmetro de Consulta

Se o seu agente não suporta autenticação bearer, você pode passar o segredo de conexão NWC como parâmetro de consulta.

Exemplo: https://mcp.getalby.com/sse?nwc=ENCODED_CONNECTION_SECRET ou https://mcp.getalby.com/mcp?nwc=ENCODED_CONNECTION_SECRET

Para obter ENCODED_CONNECTION_SECRET, abra as ferramentas de desenvolvedor do navegador (clique com o botão direito -> inspecionar) e digite isso no console, com seu próprio segredo de conexão NWC definido:

encodeURIComponent("nostr+walletconnect://...");

Caso haja uma mensagem pedindo confirmação para colar, siga as instruções e digite o comando acima novamente.

Depois que o comando for executado, copie a saída e substitua ENCODED_CONNECTION_SECRET. Ficará assim: nostr%2Bwalletconnect%3A%2F%2F...

Adicionar ao Claude Web ou Claude Desktop

Use o servidor MCP remoto da Alby

Atualmente, é necessária pelo menos uma assinatura do Claude Pro para conectar-se a servidores MCP remotos.

  1. Vá em Configurações -> Conectores
  2. Clique em "Adicionar conector personalizado"
  3. Chame-o de alby
  4. Qual é o URI do endpoint: https://mcp.getalby.com/mcp?nwc=ENCODED_NWC_URL (veja acima para instruções)

Lado do cliente

Adicione isso ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "nwc": {
      "command": "npx",
      "args": ["-y", "@getalby/mcp"],
      "env": {
        "NWC_CONNECTION_STRING": "YOUR NWC CONNECTION STRING HERE"
      }
    }
  }
}

Adicionar ao Goose Desktop

  1. Abra o Goose Desktop
  2. Vá em Configurações -> Configurações Avançadas
  3. Clique em "Adicionar extensão personalizada"
  4. Chame-o de alby e altere o tipo para HTTP Streamable
  5. Qual é o URI do endpoint SSE: https://mcp.getalby.com/mcp
  6. Tempo limite: 30
  7. Descrição: não
  8. variáveis de ambiente: não

Adicionar ao Goose CLI

Use o servidor MCP da Alby

  1. Digite goose configure
  2. Adicionar extensão -> Extensão Remota (HTTP Streamable)
  3. Chame-o de alby
  4. Qual é o URI do endpoint HTTP Streamable: https://mcp.getalby.com/mcp
  5. Tempo limite: 30
  6. Descrição: não
  7. variáveis de ambiente: não
  8. adicionar cabeçalhos personalizados: sim
  9. nome do cabeçalho: Authorization
  10. valor do cabeçalho: Bearer nostr+walletconnect://... (substitua pelo seu segredo de conexão)

Lado do cliente

  1. Digite goose configure
  2. Adicionar extensão -> Extensão de Linha de Comando
  3. Chame-o de alby
  4. Qual comando deve ser executado: npx -y @getalby/mcp
  5. Tempo limite: 30
  6. Descrição: não
  7. variáveis de ambiente: sim
  8. nome da variável de ambiente: NWC_CONNECTION_STRING
  9. valor da variável de ambiente: nostr+walletconnect://... (seu segredo de conexão NWC aqui)

Adicionar ao Cline

Copie o abaixo e cole em um prompt do Cline. Ele deve solicitar que você atualize a string de conexão.

Add the following to my MCP servers list:

"nwc": {
  "command": "npx",
  "args": ["-y", "@getalby/mcp"],
  "env": {
    "NWC_CONNECTION_STRING": "nostr+walletconnect://..."
  },
  "disabled": false,
  "autoApprove": []
}

Adicionar ao Claude Code

Use o servidor MCP da Alby

claude mcp add --transport http alby https://mcp.getalby.com/mcp --header "Authorization: Bearer nostr+walletconnect://..."

Adicionar ao N8N via SSE

Você pode usar a ferramenta nativa N8N MCP Client conectada a um agente de IA. Insira seu endpoint SSE, defina a autenticação como "Bearer" e cole seu segredo de conexão NWC.

Testado com OpenRouter + anthropic/claude-3.7-sonnet

Veja o fluxo de trabalho N8N para um exemplo simples

Adicionar ao N8N via STDIO (Nó da Comunidade)

Atualmente, este servidor MCP só funciona via linha de comando (STDIO).

Você pode instalar o nó da comunidade n8n-nodes-mcp e executar o n8n com ferramentas habilitadas, por exemplo:

N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true npx n8n

Crie um fluxo de trabalho em branco e adicione um nó de agente de IA. Configure seu modelo de LLM e adicione uma nova ferramenta "MCP Client" (que terá um cubo ao lado indicando que é um nó da comunidade).

Configure o MCP Client adicionando uma credencial com Linha de Comando (STDIO) selecionada.

comando: npx argumentos: -y @getalby/mcp ambientes NWC_CONNECTION_STRING=nostr+walletconnect://your_key_here (crie a linha inteira em um editor de texto e cole-a, pois o campo de senha não pode ser alternado para texto simples)

Veja o fluxo de trabalho de chat pago do N8N para um exemplo completo

Adicionar ao Windsurf

Use o servidor MCP remoto da Alby

  1. Baixe e abra seu editor Windsurf
  2. Clique em "Windsurf - Configurações" na barra de ferramentas na parte inferior -> "Configurações Avançadas" -> "Cascade" -> Plugins (Servidores MCP): Clique em "Gerenciar plugins" -> "Ver configuração bruta" -> você verá seu "mcp_config.json"
  3. Cole isso no seu mcp_config.json:
{
  "mcpServers": {
    "alby": {
      "serverUrl": "https://mcp.getalby.com/sse?nwc=ENCODED_NWC_URL"
    }
  }
}
  1. Substitua "ENCODED_NWC_URL" conforme descrito acima. Clique em "Salvar" e reinicie o editor Windsurf.

Modos

STDIO

Por padrão, o servidor NWC MCP é executado localmente no modo STDIO.

HTTP

Você pode definir a seguinte variável de ambiente: MODE=HTTP, que habilitará Streamable HTTP (http://localhost:3000/mcp) e SSE (http://localhost:3000/sse Nota: SSE está obsoleto).

HTTP requer autorização bearer, onde o token é o segredo de conexão NWC de uma carteira. Veja a seção de autenticação mais acima no README.

A partir do código-fonte

Pré-requisitos

  • Node.js 20+
  • Yarn
  • Uma string de conexão de uma carteira lightning que suporta NWC

Instalação

yarn install

Compilação

yarn build

Adicione sua conexão NWC

Copie .env.example para .env e atualize sua string de conexão

Inspecione as ferramentas (use/teste sem um LLM)

yarn inspect

Ferramentas Suportadas

Veja o diretório de ferramentas

Solução de Problemas

Uso do Modelo

Certifique-se de usar um modelo decente (por exemplo, Claude Sonnet 3.7), caso contrário, o servidor MCP não funcionará.

Falha ao conectar à carteira, segredo ausente

Certifique-se de copiar todo o segredo de conexão NWC, sem espaços

Contate o Suporte da Alby

Visite support.getalby.com e teremos prazer em ajudá-lo a fazer o servidor MCP funcionar.