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

Related MCP server: DexScreener MCP Server

🔭 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:

Cree un nuevo archivo TypeScript en el directorio apropiado en src/transactions/
Importar el servidor desde server/server.js
Define la herramienta usando server.tool()
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.

Servidor de protocolo de contexto del modelo de libro mayor XRP

📋 Contenido

🔭 Descripción general

✨ Características

Gestión de cuentas

Operaciones con XRP y tokens

Operaciones NFT

Identificador descentralizado (DID)

Operaciones de AMM

Verificar operaciones

Operaciones de oferta/DEX

Operaciones de Oracle

Canales de pago

Depósito

Líneas de confianza

Venta de entradas

🌐 Redes compatibles

🛠️ Requisitos previos

📦 Instalación

⚙️ Configuración del servidor

🚀 Uso

Iniciando el servidor

Conectarse al servidor

Referencia de API

Herramientas

Gestión de cuentas

Operaciones con XRP y tokens

Operaciones NFT

Operaciones DID

Operaciones de AMM

Recursos

Recursos del libro mayor

Recursos de tokens

Consideraciones de seguridad

📁 Estructura del proyecto

🛠️ Desarrollo

Agregar nuevas herramientas

Dependencias del proyecto

📄 Licencia

⚠️ Descargo de responsabilidad

Resources

New MCP Servers

Latest Blog Posts

MCP directory API