Alby MCP Server

Controla una billetera Lightning usando Nostr Wallet Connect (NWC).

GitHub
66
Prueba este MCPPatrocinado

Documentación

Alby Bitcoin Payments MCP Server

NUEVO: también echa un vistazo a Alby CLI para agentes que no soportan MCP.

Conecta una wallet de bitcoin lightning a tu LLM usando Nostr Wallet Connect (NWC).

Este servidor MCP utiliza el SDK oficial de MCP TypeScript

Este servidor MCP tiene conocimiento de NWC, LNURL y L402 usando Alby SDK y Alby Lightning Tools.

Echa un vistazo a Awesome AI Bitcoin para ver lugares donde puedes usar el Alby MCP.

Inicio rápido

En caso de que te quedes atascado, consulta la sección de solución de problemas más abajo.

Usar el servidor MCP alojado por Alby

Si tu agente soporta servidores MCP remotos - transporte SSE (p. ej. N8N) o HTTP Streamable, puedes conectarte al servidor MCP de Alby.

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

Autenticación

Ambos requieren proporcionar un secreto de conexión NWC como autenticación, ya sea como autenticación Bearer (preferida) o mediante el parámetro de consulta nwc.

Autenticación Bearer

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

Si la interfaz de tu agente soporta autenticación bearer, simplemente pega el secreto de conexión en el campo de autenticación bearer.

Parámetro de consulta

Si tu agente no soporta autenticación bearer, puedes pasar el secreto de conexión NWC como parámetro de consulta.

Ejemplo: https://mcp.getalby.com/sse?nwc=ENCODED_CONNECTION_SECRET o https://mcp.getalby.com/mcp?nwc=ENCODED_CONNECTION_SECRET

Para obtener ENCODED_CONNECTION_SECRET, abre las herramientas de desarrollador del navegador (clic derecho -> inspeccionar) e introduce esto en la consola, con tu propio secreto de conexión NWC configurado:

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

En caso de que aparezca un mensaje pidiendo confirmación para pegar, sigue las instrucciones y luego introduce el comando anterior de nuevo.

Una vez que el comando se haya ejecutado, copia la salida y reemplaza ENCODED_CONNECTION_SECRET. Se verá así: nostr%2Bwalletconnect%3A%2F%2F...

Añadir a Claude Web o Claude Desktop

Usar el servidor MCP remoto de Alby

Actualmente, se requiere al menos una suscripción a Claude Pro para poder conectarse a servidores MCP remotos.

  1. Ve a Configuración -> Conectores
  2. Haz clic en "Añadir conector personalizado"
  3. Nómbralo alby
  4. ¿Cuál es la URI del endpoint?: https://mcp.getalby.com/mcp?nwc=ENCODED_NWC_URL (ver arriba para instrucciones)

Del lado del cliente

Añade esto a tu claude_desktop_config.json:

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

Añadir a Goose Desktop

  1. Abre Goose Desktop
  2. Ve a Configuración -> Configuración avanzada
  3. Haz clic en "Añadir extensión personalizada"
  4. Nómbrala alby y cambia el tipo a HTTP Streamable
  5. ¿Cuál es la URI del endpoint SSE?: https://mcp.getalby.com/mcp
  6. Tiempo de espera: 30
  7. Descripción: no
  8. variables de entorno: no

Añadir a Goose CLI

Usar el servidor MCP de Alby

  1. Escribe goose configure
  2. Añadir extensión -> Extensión remota (HTTP Streamable)
  3. Nómbrala alby
  4. ¿Cuál es la URI del endpoint HTTP Streamable?: https://mcp.getalby.com/mcp
  5. Tiempo de espera: 30
  6. Descripción: no
  7. variables de entorno: no
  8. añadir cabeceras personalizadas: sí
  9. nombre de la cabecera: Authorization
  10. valor de la cabecera: Bearer nostr+walletconnect://... (reemplaza con tu secreto de conexión)

Del lado del cliente

  1. Escribe goose configure
  2. Añadir extensión -> Extensión de línea de comandos
  3. Nómbrala alby
  4. ¿Qué comando debe ejecutarse?: npx -y @getalby/mcp
  5. Tiempo de espera: 30
  6. Descripción: no
  7. variables de entorno: sí
  8. nombre de la variable de entorno: NWC_CONNECTION_STRING
  9. valor de la variable de entorno: nostr+walletconnect://... (tu secreto de conexión NWC aquí)

Añadir a Cline

Copia lo siguiente y pégalo en un prompt de cline. Debería pedirte que actualices la cadena de conexión.

Add the following to my MCP servers list:

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

Añadir a Claude Code

Usar el servidor MCP de Alby

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

Añadir a N8N vía SSE

Puedes usar la herramienta nativa MCP Client de N8N conectada a un agente de IA. Introduce tu endpoint SSE, configura la autenticación como "Bearer" y pega tu secreto de conexión NWC.

Probado con OpenRouter + anthropic/claude-3.7-sonnet

Consulta el flujo de trabajo de N8N para ver un ejemplo sencillo

Añadir a N8N vía STDIO (Nodo de la comunidad)

Actualmente este servidor MCP solo funciona a través de la línea de comandos (STDIO).

Puedes instalar el nodo de la comunidad n8n-nodes-mcp y ejecutar n8n con las herramientas habilitadas, p. ej.

N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true npx n8n

Crea un flujo de trabajo en blanco y añade un nodo de agente de IA. Configura tu modelo LLM y añade una nueva herramienta "MCP Client" (que tendrá un cubo al lado indicando que es un nodo de la comunidad).

Configura el MCP Client añadiendo una credencial con Línea de comandos (STDIO) seleccionada.

comando: npx argumentos: -y @getalby/mcp entornos NWC_CONNECTION_STRING=nostr+walletconnect://your_key_here (crea la línea completa en un editor de texto y pégala, ya que el campo de contraseña no se puede cambiar a texto plano)

Consulta el flujo de trabajo de chat de pago de N8N para ver un ejemplo completo

Añadir a Windsurf

Usar el servidor MCP remoto de Alby

  1. Descarga y abre tu Windsurf Editor
  2. Haz clic en "Windsurf - Configuración" en la barra de herramientas inferior -> "Configuración avanzada" -> "Cascade" -> Plugins (Servidores MCP): Haz clic en "Gestionar plugins" -> "Ver configuración sin procesar" -> verás tu "mcp_config.json"
  3. Pega esto en tu mcp_config.json:
{
  "mcpServers": {
    "alby": {
      "serverUrl": "https://mcp.getalby.com/sse?nwc=ENCODED_NWC_URL"
    }
  }
}
  1. Reemplaza "ENCODED_NWC_URL" como se describió anteriormente. Haz clic en "Guardar" y reinicia el editor de Windsurf.

Modos

STDIO

Por defecto, NWC MCP Server se ejecuta localmente en modo STDIO.

HTTP

Puedes configurar la siguiente variable de entorno: MODE=HTTP que habilitará HTTP Streamable (http://localhost:3000/mcp) y SSE (http://localhost:3000/sse Nota: SSE está obsoleto).

HTTP requiere autorización bearer, donde el token es el secreto de conexión NWC de una wallet. Consulta la sección de autenticación más arriba en el README.

Desde el código fuente

Requisitos previos

  • Node.js 20+
  • Yarn
  • Una cadena de conexión de una wallet de lightning que soporte NWC

Instalación

yarn install

Compilación

yarn build

Añade tu conexión NWC

Copia .env.example a .env y actualiza tu cadena de conexión

Inspeccionar las herramientas (usar/probar sin un LLM)

yarn inspect

Herramientas compatibles

Consulta el directorio de herramientas

Solución de problemas

Uso del modelo

Asegúrate de usar un modelo decente (p. ej. Claude Sonnet 3.7), de lo contrario el servidor MCP no funcionará.

Error al conectar con la wallet, falta el secreto

Asegúrate de haber copiado todo el secreto de conexión NWC, sin espacios

Contactar con el soporte de Alby

Visita support.getalby.com y estaremos encantados de ayudarte a que el servidor MCP funcione.