xrpl-mcp-service

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides comprehensive access to the XRP Ledger (XRPL) through various endpoints including account information, decentralized exchange functionality, NFT operations, trust lines & payments, and system operations.

Servicio XRPL MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso completo al Libro Mayor de XRP (XRPL). Este servicio permite que los modelos de IA interactúen con XRPL a través de puntos finales estandarizados.

Características

Información de la cuenta

  • xrpl_account_info - Detalles básicos de la cuenta
  • xrpl_account_balances : saldos de XRP y tokens (legibles para humanos)
  • xrpl_account_lines - Líneas de confianza
  • xrpl_account_offers - Ofertas de trading activas
  • xrpl_account_nfts - Tenencias de NFT
  • xrpl_account_tx - Historial de transacciones

Intercambio descentralizado

  • xrpl_order_book - Ver el libro de órdenes de los pares de divisas
  • xrpl_market_price - Obtener precios de mercado actuales
  • xrpl_amm_info - Información del creador de mercado automatizado

Operaciones NFT

  • xrpl_nft_offers - Ver ofertas de compra/venta de NFT

Líneas de confianza y pagos

  • xrpl_set_trust_line - Establecer nuevas líneas de confianza
  • xrpl_remove_trust_line - Eliminar líneas de confianza existentes
  • xrpl_payment_channels - Información del canal de pago
  • xrpl_find_path - Búsqueda de ruta de pago
  • xrpl_deposit_auth - Autorización de pago de cheques

Sistema

  • xrpl_server_info - Estado e información del nodo
  • xrpl_submit_tx - Enviar transacciones firmadas

Configuración

  1. Crea un archivo .env :
XRPL_NODE_URL=https://xrplcluster.com
  1. Instalar dependencias:
pip install xrpl-py fastapi uvicorn python-dotenv
  1. Ejecutar el servidor:
uvicorn main:app --host 0.0.0.0 --port 8000 --reload

Ejemplos de uso de API

Obtener información de la cuenta

POST /call-tool/xrpl_account_info { "account": "rsuUjfWxrACCAwGQDsNeZUhpzXf1n1NK5Z" }

Obtener saldos de cuentas

POST /call-tool/xrpl_account_balances { "account": "rsuUjfWxrACCAwGQDsNeZUhpzXf1n1NK5Z" }

Establecer línea de confianza

POST /call-tool/xrpl_set_trust_line { "wallet_seed": "sXXXXXXXXXXXXXXXXXXXX", "currency": "USD", "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "limit": "1000" }

Obtenga información de AMM

POST /call-tool/xrpl_amm_info { "asset": { "currency": "XRP" }, "asset2": { "currency": "USD", "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B" } }

Obtener precio de mercado

POST /call-tool/xrpl_market_price { "base_currency": { "currency": "XRP" }, "quote_currency": { "currency": "USD", "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B" } }

Estructura del proyecto

├── main.py # FastAPI application entry point ├── tools/ │ ├── __init__.py │ ├── register_tools.py # Tool registration │ └── xrpl_tools.py # XRPL endpoint implementations

Componentes clave

  1. xrpl_tools.py
    • Funciones principales de interacción XRPL
    • Implementación asincrónica con manejo de bucles de eventos
    • Manejo de errores y formato de respuesta
  2. herramientas_de_registro.py
    • Registro de herramientas MCP
    • Mapeo y configuración de puntos finales

Mejoras futuras

  1. Operaciones de AMM (Fondo de Liquidez)
    • Crear grupos
    • Añadir o eliminar liquidez
    • Votación sobre los parámetros del pool
  2. Trading avanzado
    • Crear/cancelar ofertas
    • Funciones de trading automatizadas
    • alertas de precios
  3. Operaciones NFT
    • NFT de Mint
    • Crear/aceptar ofertas
    • Gestión de cobros

Problemas comunes

  1. Bucle de eventos asincrónicos : si ve "asyncio.run() no se puede llamar desde un bucle de eventos en ejecución", verifique la implementación asincrónica en xrpl_tools.py
  2. Limitación de velocidad : considere implementar una limitación de velocidad para el uso en producción

Contribuyendo

  1. Bifurcar el repositorio
  2. Crear una rama de características
  3. Implementa tus cambios
  4. Enviar una solicitud de extracción

Notas importantes

  • Utilice siempre un libro mayor "validado" para la producción
  • Semillas de billetera segura y claves privadas
  • Monitorear las tarifas de transacción
  • Pruebe exhaustivamente en la red de prueba primero

Recursos

Licencia

Instituto Tecnológico de Massachusetts (MIT)

-
security - not tested
F
license - not found
-
quality - not tested

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso completo al Libro Mayor de XRP (XRPL). Este servicio permite que los modelos de IA interactúen con XRPL a través de puntos finales estandarizados.

  1. Features
    1. Account Information
    2. Decentralized Exchange
    3. NFT Operations
    4. Trust Lines & Payments
    5. System
  2. Setup
    1. API Usage Examples
      1. Get Account Info
      2. Get Account Balances
      3. Set Trust Line
      4. Get AMM Info
      5. Get Market Price
    2. Project Structure
      1. Key Components
        1. Future Enhancements
          1. Common Issues
            1. Contributing
              1. Important Notes
                1. Resources
                  1. License
                    ID: qh6y5cvx2o