NWC MCP Server

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

Documentação

⚠️ OBSOLETO ⚠️

Por favor, use Alby MCP em vez disso!

Este repositório foi descontinuado em favor do Alby MCP, que inclui todas as ferramentas NWC juntamente com ferramentas adicionais de Lightning.

NWC MCP Server

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

Este servidor MCP usa o SDK oficial MCP TypeScript

Veja também o servidor Alby MCP que inclui ferramentas úteis adicionais.

Início Rápido

Use o Servidor MCP Hospedado pela Alby

Se o seu agente suporta SSE (ex.: 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

Ambos exigem fornecer um segredo de conexão NWC como autenticação Bearer.

Adicionar ao Claude Desktop

Adicione isso ao seu claude_desktop_config.json:

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

Adicionar ao Goose

  1. Digite goose configure
  2. Adicione extensão -> Extensão de Linha de Comando
  3. Chame de nwc
  4. Qual comando deve ser executado: npx -y @getalby/nwc-mcp-server
  5. Timeout: 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/nwc-mcp-server"],
  "env": {
    "NWC_CONNECTION_STRING": "nostr+walletconnect://..."
  },
  "disabled": false,
  "autoApprove": []
}

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 n8n-nodes-mcp nó da comunidade 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 LLM e adicione uma nova ferramenta "MCP Client" (que terá um cubo ao lado mostrando que é um nó da comunidade).

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

comando: npx argumentos: -y @getalby/nwc-mcp-server variáveis de ambiente 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

Modos

STDIO

Por padrão, o NWC MCP Server é 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.

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