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
Used for environment variable management and configuration, allowing the server to securely store sensitive data like wallet seeds and network selection.
Serves as the runtime environment for the MCP server, with version 18.0.0 or higher required as a prerequisite.
Implementation language for the MCP server, providing type safety and modern language features.
Servidor de protocolo de contexto del modelo de libro mayor XRP
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
- Características
- Redes compatibles
- Prerrequisitos
- Instalación
- Configuración del servidor
- Uso
- Referencia de API
- Consideraciones de seguridad
- Estructura del proyecto
- Desarrollo
- Licencia
🔭 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
⚙️ Configuración del servidor
Cree un archivo .env en la raíz del proyecto con las siguientes variables:
🚀 Uso
Iniciando el servidor
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
🛠️ 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 MCPxrpl: API de JavaScript/TypeScript para el libro mayor de XRPdotenv: Gestión de variables de entornozod: 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
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.