Servidor XRPL MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona a los modelos de IA acceso a los datos y la funcionalidad de XRP Ledger.

Descripción general

El servidor MCP de XRPL actúa como puente entre los grandes modelos de lenguaje (LLM), como Claude y GPT, y el Libro Mayor de XRP. Permite que los modelos de IA recuperen información de cuentas del Libro Mayor de XRP a través de una interfaz API estandarizada.

Características

• Obtener información de la cuenta (saldo, número de secuencia)
• Consulta de líneas de confianza y monedas emitidas
• Ver NFT propiedad de las cuentas
• Recuperar el historial de transacciones
• Acceda a los datos del libro de órdenes desde el DEX
• Enviar transacciones firmadas a la red
• Obtener información del estado del servidor
• Acceso confiable a los datos del libro mayor de XRP a través de MCP
• Fácil integración con aplicaciones de IA compatibles con MCP

Instalación

De la fuente

1. Clonar este repositorio:
   git clone https://github.com/lgcarrier/xrpl-mcp-server.git cd xrpl-mcp-server
2. Crear y activar un entorno virtual:
   python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
3. Instalar dependencias:
   pip install -r requirements.txt

Usando pip

Configuración

El servidor utiliza las siguientes variables de entorno:

• XRPL_NODE_URL : URL del nodo de XRP Ledger (el valor predeterminado es " https://s1.ripple.com:51234/ ")

Uso

Ejecutar desde la fuente

Iniciar el servidor:

Ejecutar como paquete instalado

Uso con Claude u otros asistentes de IA compatibles con MCP

1. Instalar el MCP:
   mcp install xrpl-mcp-server
2. Las herramientas XRPL estarán disponibles para Claude, lo que le permitirá solicitar información de la cuenta XRP Ledger.

Herramientas disponibles

obtener_información_de_la_cuenta

Recupera información sobre una cuenta XRP Ledger.

Parámetros:

• address (cadena): La dirección de la cuenta XRP Ledger (comienza con "r")

Devoluciones:

• Saldo de la cuenta en XRP
• Número de secuencia de cuenta

obtener_líneas_de_cuenta

Recupera líneas de confianza para una cuenta XRP Ledger.

Parámetros:

• address (cadena): La dirección de la cuenta XRP Ledger (comienza con "r")
• peer (cadena, opcional): Dirección de una cuenta de contraparte para filtrar resultados
• limit (entero, opcional): límite para la cantidad de líneas de confianza devueltas

Devoluciones:

• Información en formato JSON sobre las líneas de confianza de la cuenta

obtener_cuenta_nfts

Recupera NFT propiedad de una cuenta XRP Ledger.

Parámetros:

• address (cadena): La dirección de la cuenta XRP Ledger (comienza con "r")
• limit (entero, opcional): límite para la cantidad de NFT devueltos

Devoluciones:

• Información en formato JSON sobre los NFT de la cuenta

obtener_transacciones_de_cuenta

Recupera el historial de transacciones de una cuenta XRP Ledger.

Parámetros:

• address (cadena): La dirección de la cuenta XRP Ledger (comienza con "r")
• limit (entero, opcional): límite para la cantidad de transacciones devueltas
• binary (booleano, opcional): Indicador para devolver transacciones en formato binario (predeterminado Falso)
• forward (booleano, opcional): Indicador para buscar hacia adelante en el historial del libro mayor (predeterminado Falso)

Devoluciones:

• Información en formato JSON sobre el historial de transacciones de la cuenta

obtener_información_del_servidor

Recupera información sobre el servidor XRP Ledger conectado.

Parámetros:

• Ninguno

Devoluciones:

• Información en formato JSON sobre el servidor XRP Ledger

enviar_transacción

Envía un blob de transacción firmado al libro mayor XRP.

Parámetros:

• tx_blob (cadena): El blob de transacción firmado en formato hexadecimal

Devoluciones:

• Resultado del envío en formato JSON

obtener_información_de_transacción

Recupera información sobre una transacción específica.

Parámetros:

• transaction_hash (cadena): El hash de la transacción

Devoluciones:

• Detalles de transacciones en formato JSON

obtener ofertas de libros

Recupera ofertas del libro de órdenes para un par de divisas en el DEX.

Parámetros:

• taker_gets (objeto): Moneda que el tomador quiere recibir, p. ej., {"currency": "XRP"} o {"currency": "USD", "issuer": "r..."}
• taker_pays (objeto): Moneda que el receptor quiere pagar, p. ej., {"currency": "EUR", "issuer": "r..."} o {"currency": "XRP"}
• limit (entero, opcional): límite para la cantidad de ofertas devueltas

Devoluciones:

• Ofertas de libros de pedidos con formato JSON

Ejemplos

Pregúntale a Claude:

¿Cuál es el saldo de la cuenta XRP rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe?

Luego, Claude puede usar la herramienta get_account_info para obtener esta información directamente del XRP Ledger.

Ejemplo de respuesta:

He aquí otro ejemplo:

¿Qué NFT posee la cuenta rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe?

Claude puede usar la herramienta get_account_nfts para recuperar esta información.

Desarrollo

Consulte el directorio memory-bank para obtener documentación detallada sobre la arquitectura, las reglas de codificación y los planes de implementación.

Para configurar el entorno de desarrollo:

Licencia

Licencia MIT