Core Lightning MCP Server

Servidor MCP Core Lightning

Um servidor gRPC baseado em Rust que fornece uma interface padronizada para nós Core Lightning. Este servidor implementa a especificação MCP (Model Context Protocol) para permitir o controle do nó Core Lightning usando LLM.

Instalação

Opção 1: A partir do Release (Recomendado)

1. Baixe o binário apropriado para sua plataforma no último release
2. Extraia o arquivo:

   # For Linux/macOS
   tar -xzf cln-mcp-<platform>.tar.gz
   
   # For Windows
   # Use your preferred zip extractor
   

3. Torne o binário executável (somente Linux/macOS):

   chmod +x cln-mcp
   

Opção 2: A partir do Código-Fonte

Pré-requisitos

• Rust 1.80 ou superior
• Protocol Buffers Compiler (protoc)
• Core Lightning (com gRPC habilitado)
• Clientes MCP (Claude, Goose, etc.)

Protocol Buffers Compiler (protoc)

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y protobuf-compiler

macOS:

brew install protobuf

Windows:

choco install protoc

Verifique a instalação:

protoc --version  # Should show version 3.0.0 or higher

1. Clone o repositório:

git clone https://github.com/adi2011/cln-mcp.git
cd cln-mcp

2. Compile o projeto:

cargo build --release

Configuração

O servidor pode ser configurado usando argumentos de linha de comando:

cln-mcp [OPTIONS]

Options:
  --certs-dir <path>    Path to certificates directory
  --node-address <url>  Node address (default: https://localhost:9736)
  --help                Shows help message

Configuração de Certificados TLS

Adicione a opção --grpc-port(padrão: 9736) ao executar o CLN, e ele gerará automaticamente os certificados mTLS apropriados.

Copie os seguintes arquivos PEM do diretório Lightning para um diretório separado:

• ca.pem: Certificado da CA
• client.pem: Certificado do cliente
• client-key.pem: Chave privada do cliente

Configuração do Claude

• Instale o Claude
• Vá para configurações -> Desenvolvedor
• Editar Config

   {
       "mcpServers" : {
           "cln-mcp" : {
               "command": "Path/to/cln-mcp" (ex: "/Users/MyPC/cln-mcp/target/release/cln-mcp" or the executable unzipped from the release),
               "args": [
                   "--certs-dir",
                   "Path/to/certificates" (ex: "/Users/MyPC/cln-mcp/certs")
               ]
           }
       }
   }

• Reinicie o Claude

Metas Futuras

[ ] Permitir que ele derive parâmetros para as chamadas RPC
[ ] Escolher os RPCs mais apropriados e úteis para máxima utilidade
[ ] Estender o suporte para LND
[ ] Hospedar múltiplos servidores para torná-lo mais eficiente

Este é um trabalho em andamento. Agradecemos revisões de código, pull requests e issues baseadas no seu uso.