XRPL MCP

XRPL MCP

XRPL MCP es una implementación de servidor de Protocolo de Contexto de Modelo (MCP) para la cadena de bloques XRP Ledger, compatible con clientes MCP como Claude Desktop o Cursor.ai. Permite gestionar operaciones de billetera, creación de tokens, NFT y comercio DEX mediante herramientas integrales.

Características

• Más de 15 herramientas MCP que cubren gestión de cuentas, operaciones con tokens, gestión de NFT y comercio DEX
• Integración completa con XRPL para pagos, líneas de confianza y gestión de cuentas
• Soporte para NFToken para acuñar, quemar y gestionar tokens no fungibles
• Capacidades de comercio DEX con acceso al libro de órdenes y gestión de ofertas
• Gestión integral de transacciones con análisis detallados e historial
• Creación y gestión de tokens con ajustes configurables y funciones de cumplimiento

Uso con Claude Desktop

1. Instala Claude Desktop si aún no lo has hecho
2. Abre la configuración de Claude Desktop
3. Añade el cliente XRPL MCP a tu configuración:

{
  "mcpServers": {
    "xrpl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tamago-labs/xrpl-mcp",
        "--xrpl_private_key=YOUR_PRIVATE_KEY", 
        "--xrpl_network=mainnet"
      ],
      "disabled": false
    }
  }
}

Este modo de clave privada se recomienda para usuarios avanzados que puedan gestionar sus claves privadas de forma segura. El cliente MCP maneja las transacciones localmente sin exponer ningún dato a servidores externos.

Casos de uso

1. Gestión profesional de tokens

El agente se integra con las funciones nativas de XRPL para ayudarte a:

• Crear y configurar tokens personalizados con ajustes de cumplimiento
• Gestionar líneas de confianza para la emisión y distribución de tokens
• Monitorear saldos de tokens en múltiples monedas
• Ejecutar transferencias de tokens con etiquetas de destino y memos
• Rastrear el historial de transacciones y analizar patrones de pago

2. Creación y comercio de NFT

El agente asiste con operaciones de NFToken:

• Acuñar NFTokens únicos con metadatos personalizados y tarifas de transferencia
• Quemar NFTokens no deseados para limpiar colecciones
• Establecer restricciones de transferencia y estructuras de regalías
• Gestionar colecciones de NFT con la categorización adecuada

3. Comercio DEX y creación de mercado

El agente proporciona herramientas comerciales profesionales:

• Crear y gestionar ofertas de comercio en el DEX nativo de XRPL
• Monitorear libros de órdenes para una ejecución óptima de operaciones
• Rastrear ofertas activas y rendimiento de la cartera
• Ejecutar estrategias de creación de mercado con gestión automatizada de ofertas

Herramientas disponibles (15 herramientas)

Operaciones principales de billetera

Nombre de la herramienta	Descripción	Ejemplo de uso
xrpl_get_wallet_address	Obtén la dirección de tu billetera	"¿Cuál es la dirección de mi billetera?"
xrpl_get_account_info	Obtén información detallada de la cuenta	"Muestra los detalles de mi cuenta"
xrpl_get_balances	Obtén todos los saldos de tokens	"Muestra mis saldos de tokens"
xrpl_send_payment	Envía XRP o tokens a otra dirección	"Envía 100 XRP a rAddress..."

Gestión de tokens

Nombre de la herramienta	Descripción	Ejemplo de uso
xrpl_create_token	Crea un nuevo token con ajustes personalizados	"Crea un token con el símbolo USD y requiere autorización"
xrpl_set_trust_line	Establece una línea de confianza para un token	"Establece una línea de confianza para el token USD de rIssuer..."

Operaciones con NFToken

Nombre de la herramienta	Descripción	Ejemplo de uso
xrpl_mint_nftoken	Acuña un nuevo NFToken	"Acuña un NFT con URI https://metadata.com/1"
xrpl_burn_nftoken	Quema un NFToken existente	"Quema el NFToken con ID 0xABC..."

Comercio DEX

Nombre de la herramienta	Descripción	Ejemplo de uso
xrpl_create_offer	Crea una oferta de comercio	"Crea una oferta para vender 1000 USD por 500 XRP"
xrpl_cancel_offer	Cancela una oferta existente	"Cancela mi oferta con secuencia 123"
xrpl_get_order_book	Obtén el libro de órdenes para un par de comercio	"Muestra el libro de órdenes de USD/XRP"
xrpl_get_account_offers	Obtén todas las ofertas activas de la cuenta	"Muestra mis ofertas de comercio activas"

Gestión de transacciones

Nombre de la herramienta	Descripción	Ejemplo de uso
xrpl_get_transaction	Obtén información detallada de una transacción	"Muestra los detalles de la transacción 0xABC..."
xrpl_get_recent_transactions	Obtén transacciones recientes con análisis	"Muestra mis últimas 20 transacciones"

Ejemplos avanzados de flujos de trabajo XRPL

Estrategia completa de emisión de tokens

User: "Help me create and distribute a new token for my business"

Agent: 
1. Uses xrpl_create_token to create token with proper compliance settings
2. Uses xrpl_set_trust_line to establish initial trust relationships
3. Uses xrpl_send_payment to distribute tokens to holders
4. Provides ongoing monitoring and management recommendations

Gestión de colecciones de NFT

User: "I want to create and manage an NFT collection with royalties"

Agent:
1. Uses xrpl_mint_nftoken to create NFTs with transfer fees
2. Uses xrpl_get_account_info to monitor collection status
3. Tracks secondary sales and royalty collection
4. Provides collection analytics and optimization strategies

Creación de mercado DEX

User: "Set up market making for my token on XRPL DEX"

Agent:
1. Uses xrpl_get_order_book to analyze current market conditions
2. Uses xrpl_create_offer to place buy and sell orders
3. Uses xrpl_get_account_offers to monitor active positions
4. Automatically adjusts spreads based on market activity

Análisis de transacciones

User: "Analyze my recent XRPL activity and optimize my operations"

Agent:
1. Uses xrpl_get_recent_transactions to fetch detailed history
2. Uses xrpl_get_transaction for in-depth analysis of each transaction
3. Analyzes fee patterns and provides optimization strategies
4. Shows token usage and trading efficiency metrics

Antecedentes

El Protocolo de Contexto de Modelo (MCP), introducido por Claude AI a finales de 2024, resuelve el desafío de las aplicaciones de IA en rápida evolución en el ámbito de las criptomonedas. A diferencia de los kits de agentes tradicionales que acoplan estrechamente los modelos de IA y los componentes, MCP proporciona interfaces estandarizadas que permanecen estables a medida que los modelos evolucionan.

XRPL MCP aprovecha esta arquitectura para proporcionar herramientas de cadena de bloques de nivel profesional que funcionan sin problemas en diferentes interfaces de IA, permitiendo a los usuarios gestionar operaciones complejas de XRPL mediante interacciones en lenguaje natural.

Solución de problemas

Si estás usando Ubuntu u otro entorno Linux con NVM, deberás configurar la ruta manualmente. Sigue estos pasos:

1. Instala XRPL MCP bajo tu versión actual de Node.js gestionada por NVM.

npm install -g @tamago-labs/xrpl-mcp

2. Debido a cómo NVM instala las bibliotecas, es posible que necesites usar rutas absolutas en tu configuración. Reemplaza los valores de ejemplo a continuación con tu nombre de usuario y versión de Node reales:

{
  "mcpServers": {
    "xrpl-mcp": {
      "command": "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/node",
      "args": [
        "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/@tamago-labs/xrpl-mcp",
        "--xrpl_private_key=YOUR_PRIVATE_KEY",
        "--xrpl_network=mainnet"
      ]
    }
  }
}

3. Reinicia Claude Desktop y debería funcionar ahora.

Licencia

Este proyecto está licenciado bajo la Licencia MIT.