Skip to main content
Glama
enesjakozh

xrpl mcp

by RomThpt
GitHub
TypeScript
MIT License
5
  • Linux
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Servidor de protocolo de contexto del modelo de libro mayor XRP

Servidor MCP

Licencia: MIT | Redes XRPL | TypeScript | xrpl.js

Un servidor integral de Protocolo de Contexto de Modelo (MCP) que proporciona servicios de blockchain para el ecosistema XRP Ledger. Este servidor permite a los agentes de IA interactuar con las redes principal, de prueba y de desarrollo de XRPL mediante una interfaz unificada.

📋 Contenido

🔭 Descripción general

El servidor MCP XRPL aprovecha el Protocolo de Contexto de Modelo para proporcionar servicios de contabilidad XRP a agentes de IA. Admite una amplia gama de servicios, entre ellos:

  • Lectura del estado del libro mayor (saldos, transacciones, información de cuentas, etc.)

  • Interactuar con contratos inteligentes (a través de Hooks)

  • Transferencia de XRP y tokens emitidos

  • Consulta de metadatos y saldos de tokens

  • Gestión de identificadores descentralizados (DID)

  • Trabajar con NFT en XRPL

  • Operaciones de creadores de mercado automatizados (AMM)

  • Canales de pago, fideicomisos y cheques

  • Operaciones de datos de Oracle

  • Gestión de líneas de confianza

Todos los servicios se exponen a través de una interfaz consistente de herramientas y recursos MCP, lo que facilita que los agentes de IA descubran y utilicen la funcionalidad XRPL.

✨ Características

Gestión de cuentas

  • Conectarse a redes XRPL (MainNet, TestNet, DevNet)

  • Recuperación de información de la cuenta

  • Gestión de propiedades de cuentas

  • Preautorización de depósito

  • Gestión regular de claves

Operaciones con XRP y tokens

  • Transferir XRP entre cuentas

  • Obtener metadatos del token (nombre, símbolo, decimales, suministro)

  • Consultar saldos de tokens

  • Transferir tokens entre direcciones

  • Aprobar el gasto de tokens

  • Recuperación de tokens

Operaciones NFT

  • Acuñar NFT en el libro mayor de XRP

  • Ver metadatos de NFT

  • Verificar la propiedad del NFT

  • Transferir NFT entre direcciones

  • Consigue colecciones de NFT

Identificador descentralizado (DID)

  • Crear DID en el XRPL

  • Resolver DID

  • Actualizar documentos DID

  • Desactivar DID

Operaciones de AMM

  • Crear creadores de mercado automatizados

  • Depósito a AMM

  • Realizar ofertas en AMM

  • Votación sobre los parámetros de AMM

  • Eliminar AMM

  • Recuperación de activos de los AMM

Verificar operaciones

  • Crear cheques

  • cobrar cheques

  • Cancelar cheques

Operaciones de oferta/DEX

  • Crear ofertas

  • Cancelar ofertas

Operaciones de Oracle

  • Establecer datos de Oracle

  • Eliminar datos de Oracle

Canales de pago

  • Crear canales de pago

  • Canales de pago de fondos

  • Reclamación de los canales de pago

Depósito

  • Crear fideicomisos

  • Finalizar los fideicomisos

  • Cancelar fideicomisos

Líneas de confianza

  • Establecer y administrar líneas de confianza

Venta de entradas

  • Crear tickets para el procesamiento de transacciones

🌐 Redes compatibles

  • MainNet : Red de producción de XRP Ledger

  • TestNet : Red de pruebas para el desarrollo

  • DevNet : Red de desarrollo para funciones experimentales

🛠️ Requisitos previos

  • Node.js 18.0.0 o superior

📦 Instalación

# Clone the repository git clone https://github.com/yourusername/mcp-xrpl.git cd mcp-xrpl # Install dependencies npm install # Build the project npm run build

⚙️ Configuración del servidor

Cree un archivo .env en la raíz del proyecto con las siguientes variables:

# Optional: XRPL wallet seed for automatic connection # If not provided, you can connect using the connect-to-xrpl tool DEFAULT_SEED=sEdVoKkRRF8RsNYZ689NDeMyrijiCbg # Example - replace with your own or remove # Network selection (default is "testnet") XRPL_NETWORK=testnet # Options: mainnet, testnet, devnet

🚀 Uso

Iniciando el servidor

# Start the server in stdio mode (for CLI tools) npm start

Conectarse al servidor

Conéctese a este servidor MCP con cualquier cliente compatible con MCP. Para realizar pruebas y depurar, puede usar el Inspector de MCP.

Referencia de API

Herramientas

El servidor proporciona las siguientes herramientas MCP para los agentes:

Gestión de cuentas

Nombre de la herramienta

Descripción

Parámetros clave

connect-to-xrpl

Conéctese a XRP Ledger usando una semilla

semilla, red

get-account-info

Obtener información de la cuenta

dirección, red

delete-account

Eliminar una cuenta XRPL

clave privada, destino, red

set-account-properties

Establecer propiedades de la cuenta

clave privada, propiedades, red

deposit-preauth

Preautorizar un depósito

clave privada, autorizar, red

set-regular-key

Establecer una clave regular para una cuenta

clave privada, clave regular, red

Operaciones con XRP y tokens

Nombre de la herramienta

Descripción

Parámetros clave

transfer-xrp

Enviar XRP a una cuenta

clave privada, a, cantidad, red

get-token-metadata

Obtener metadatos del token

dirección de token, red

check-token-balance

Consultar el saldo del token

dirección del token, dirección del propietario, red

transfer-token

Tokens de transferencia

clave privada, dirección del token, a, cantidad, red

approve-token-spending

Aprobar el gasto de tokens

clave privada, dirección de token, límite, red

token-clawback

Fichas de recuperación

clave privada, dirección del token, de, cantidad, red

Operaciones NFT

Nombre de la herramienta

Descripción

Parámetros clave

nft-mint

Acuñar un NFT

clave privada, uri, indicadores, red

get-nft-info

Obtener metadatos de NFT

tokenID, red

check-nft-ownership

Verificar la propiedad del NFT

tokenID, dirección del propietario, red

transfer-nft

Transferir un NFT

clave privada, ID de token, a, red

get-nft-collection

Consigue NFT en una colección

dirección, red

Operaciones DID

Nombre de la herramienta

Descripción

Parámetros clave

create-did

Crear un DID

clave privada, datos, red

resolve-did

Resolver un DID

hizo, red

update-did

Actualizar un DID

clave privada, hizo, datos, red

deactivate-did

Desactivar un DID

clave privada, hizo, red

Operaciones de AMM

Nombre de la herramienta

Descripción

Parámetros clave

amm-create

Crear un AMM

clave privada, activos, red

amm-deposit

Depositar en un AMM

clave privada, ammID, activos, red

amm-bid

Realizar una oferta en un AMM

clave privada, ammID, oferta, red

amm-vote

Votación sobre los parámetros de AMM

clave privada, ammID, voto, red

amm-delete

Eliminar un AMM

clave privada, ammID, red

amm-clawback

Recuperación de activos de AMM

clave privada, ammID, activos, red

Recursos

El servidor expone datos XRPL a través de las siguientes URI de recursos MCP:

Recursos del libro mayor

Patrón de URI de recurso

Descripción

xrpl://{network}/ledger/current

Información del libro mayor actual

xrpl://{network}/ledger/{ledger_index}

Libro mayor por índice

xrpl://{network}/account/{address}

Información de la cuenta

xrpl://{network}/account/{address}/balance

Saldo de la cuenta XRP

xrpl://{network}/tx/{tx_hash}

Detalles de la transacción

Recursos de tokens

Patrón de URI de recurso

Descripción

xrpl://{network}/token/{currency}/{issuer}

Información del token

xrpl://{network}/token/{currency}/{issuer}/balanceOf/{address}

Saldo de tokens

xrpl://{network}/nft/{tokenID}

Información de NFT

xrpl://{network}/nft/{tokenID}/owner

Información de propiedad de NFT

Consideraciones de seguridad

  • Las semillas de billetera se utilizan solo para la firma de transacciones y deben mantenerse seguras.

  • Considere implementar mecanismos de autenticación adicionales para el uso en producción

  • Para servicios de alto valor, considere agregar pasos de confirmación

  • Las operaciones predeterminadas se realizan en TestNet para garantizar la seguridad durante el desarrollo.

  • Utilice variables de entorno para una configuración sensible

📁 Estructura del proyecto

mcp-xrpl/ ├── src/ │ ├── core/ # Core utilities and services │ │ ├── constants.ts # XRPL network URLs and other constants │ │ ├── state.ts # State management for connected wallet │ │ ├── utils.ts # Helper functions │ │ └── services/ # Service modules │ ├── server/ # MCP server implementation │ ├── transactions/ # XRPL transaction implementation │ │ ├── token/ # Token-related transactions │ │ ├── nft/ # NFT-related transactions │ │ ├── did/ # DID-related transactions │ │ ├── amm/ # AMM-related transactions │ │ ├── check/ # Check-related transactions │ │ ├── offer/ # Offer-related transactions │ │ ├── oracle/ # Oracle-related transactions │ │ ├── payment/ # Payment-related transactions │ │ ├── escrow/ # Escrow-related transactions │ │ └── trust/ # Trust line-related transactions │ └── index.ts # Entry point ├── build/ # Compiled JavaScript output ├── package.json ├── package-lock.json └── tsconfig.json

🛠️ Desarrollo

Agregar nuevas herramientas

Para agregar una nueva herramienta:

  1. Cree un nuevo archivo TypeScript en el directorio apropiado en src/transactions/

  2. Importar el servidor desde server/server.js

  3. Define la herramienta usando server.tool()

  4. Importar la herramienta en src/index.ts

Dependencias del proyecto

  • @modelcontextprotocol/sdk : SDK de MCP

  • xrpl : API de JavaScript/TypeScript para el libro mayor de XRP

  • dotenv : Gestión de variables de entorno

  • zod : Declaración y validación de esquemas basados en TypeScript

📄 Licencia

Este proyecto está licenciado bajo los términos de la Licencia MIT.

⚠️ Descargo de responsabilidad

Este software se proporciona únicamente con fines educativos y de desarrollo. Úselo bajo su propia responsabilidad. Realice siempre pruebas exhaustivas en la red de prueba antes de usarlo en la red principal con XRP real.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

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.

Servidor CP que proporciona integración con XRP Ledger. Este servidor permite a los asistentes de IA acceder a la información de la cuenta, el historial de transacciones y los datos de la red en XRP Ledger, con capacidades para consultar objetos del libro mayor, enviar transacciones y monitorear la red.

  1. 📋 Contenido
    1. 🔭 Descripción general
      1. ✨ Características
        1. Gestión de cuentas
        2. Operaciones con XRP y tokens
        3. Operaciones NFT
        4. Identificador descentralizado (DID)
        5. Operaciones de AMM
        6. Verificar operaciones
        7. Operaciones de oferta/DEX
        8. Operaciones de Oracle
        9. Canales de pago
        10. Depósito
        11. Líneas de confianza
        12. Venta de entradas
      2. 🌐 Redes compatibles
        1. 🛠️ Requisitos previos
          1. 📦 Instalación
            1. ⚙️ Configuración del servidor
              1. 🚀 Uso
                1. Iniciando el servidor
                2. Conectarse al servidor
              2. Referencia de API
                1. Herramientas
                2. Recursos
              3. Consideraciones de seguridad
                1. 📁 Estructura del proyecto
                  1. 🛠️ Desarrollo
                    1. Agregar nuevas herramientas
                    2. Dependencias del proyecto
                  2. 📄 Licencia
                    1. ⚠️ Descargo de responsabilidad

                      Related MCP Servers

                      • xrpl-mcp-service

                        tedlikeskix
                        -
                        security
                        F
                        license
                        -
                        quality
                        A Model Context Protocol (MCP) server providing comprehensive access to the XRP Ledger (XRPL). This service enables AI models to interact with XRPL through standardized endpoints.
                        Last updated -
                        3

                      • DexScreener MCP Server

                        openSVM
                        A
                        security
                        A
                        license
                        A
                        quality
                        An MCP server implementation that enables access to DexScreener API data, providing real-time information on DEX pairs, token profiles, and market statistics across multiple blockchains.
                        Last updated -
                        7
                        17
                        The Unlicense

                      • XTBApiServer

                        sharplygroup
                        -
                        security
                        F
                        license
                        -
                        quality
                        An MCP server that exposes the XTB trading API, allowing users to interact with their XTB trading accounts through the Model Context Protocol to perform operations like account management, market data retrieval, and trade execution.
                        Last updated -
                        1
                        1

                      • Armor Crypto MCPofficial

                        armorwallet
                        A
                        security
                        A
                        license
                        A
                        quality
                        An MCP server providing unified access to blockchain operations, bridging, swapping, and crypto trading strategies for AI agents.
                        Last updated -
                        37
                        188
                        GPL 3.0
                        • Apple
                        • Linux

                      View all related MCP servers

                      New MCP Servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/RomThpt/mcp-xrpl'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server