Core Lightning MCP Server

Servidor MCP de Core Lightning

Un servidor gRPC basado en Rust que proporciona una interfaz estandarizada para nodos de Core Lightning. Este servidor implementa la especificación MCP (Model Context Protocol) para permitir el control del nodo de Core Lightning mediante LLM.

Instalación

Opción 1: Desde la versión publicada (Recomendado)

1. Descargue el binario apropiado para su plataforma desde la última versión publicada
2. Extraiga el archivo:

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

3. Haga ejecutable el binario (solo Linux/macOS):

   chmod +x cln-mcp
   

Opción 2: Desde el código fuente

Requisitos previos

• Rust 1.80 o superior
• Compilador de Protocol Buffers (protoc)
• Core Lightning (con gRPC habilitado)
• Clientes MCP (Claude, Goose, etc.)

Compilador de Protocol Buffers (protoc)

Ubuntu/Debian:

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

macOS:

brew install protobuf

Windows:

choco install protoc

Verifique la instalación:

protoc --version  # Should show version 3.0.0 or higher

1. Clone el repositorio:

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

2. Compile el proyecto:

cargo build --release

Configuración

El servidor se puede configurar usando argumentos de línea de comandos:

cln-mcp [OPTIONS]

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

Configuración de certificados TLS

Agregue la opción --grpc-port(predeterminado: 9736) mientras ejecuta CLN, y generará automáticamente los certificados mTLS apropiados.

Copie los siguientes archivos PEM del directorio de Lightning a un directorio separado:

• ca.pem: Certificado de CA
• client.pem: Certificado de cliente
• client-key.pem: Clave privada del cliente

Configuración de Claude

• Instale Claude
• Vaya a configuración -> Desarrollador
• Editar configuración

   {
       "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 Claude

Objetivos futuros

[ ] Permitir que derive parámetros para las llamadas RPC
[ ] Elegir los RPC más apropiados y útiles para máxima utilidad
[ ] Ampliar el soporte para LND
[ ] Alojar múltiples servidores para hacerlo más eficiente

Este es un trabajo en progreso. Agradecemos revisiones de código, solicitudes de extracción (pull requests) y problemas basados en su uso.