1inch Cross-Chain Swap MCP Server

Herramienta de intercambio de cadena cruzada de 1 pulgada

Una herramienta para ejecutar intercambios de tokens entre cadenas utilizando 1inch Fusion+ y Model Context Protocol (MCP).

Vídeo de demostración

Descripción general

Esta herramienta facilita el intercambio de tokens entre diferentes cadenas de bloques (Arbitrum, Base, Polygon, etc.) mediante la API Fusion+ de 1inch. Gestiona todo el proceso de intercambio, desde la iniciación de órdenes hasta la monitorización de su estado de ejecución mediante un sistema de trabajo en segundo plano.

Instalación

Las dependencias deben instalarse utilizando pnpm o yarn y no npm :

Configuración

El proyecto debe configurarse como un proyecto CommonJS. El diseño de la biblioteca no funciona en su formato actual si se importa como ESM.

1. Cree un archivo .env en el directorio raíz y rellénelo con las siguientes variables:

Uso

Iniciar el servidor MCP

Esto inicia el servidor del Protocolo de Contexto de Modelo que expone herramientas para el intercambio entre cadenas y la gestión de carteras.

Herramientas MCP disponibles

La herramienta proporciona las siguientes funciones MCP que se pueden utilizar con Claude u otros asistentes compatibles con MCP:

Intercambio entre cadenas

• swap : inicia un intercambio de tokens entre cadenas
  Parameters: - srcChainId: Source chain ID (default: 8453/Base) - dstChainId: Destination chain ID (default: 42161/Arbitrum) - srcTokenAddress: Source token address - dstTokenAddress: Destination token address - amount: Amount to swap (in base units or human-readable format) - invert: Swap direction toggle (default: false)

Gestión de pedidos

• swap-status : Comprueba el estado de las órdenes de swap
  Parameters: - orderHash: (Optional) Specific order hash to check

Gestión de cartera

• portfolio-protocols-value : Obtiene el valor de los protocolos en su cartera
  Parameters: - chainId: Blockchain ID (default: 1/Ethereum)
• portfolio-tokens-details : obtiene información detallada sobre los tokens en su cartera
  Parameters: - chainId: Blockchain ID (default: 1/Ethereum) - closed: Include closed positions (default: true) - closedThreshold: Threshold for considering positions closed (default: 1)
• portfolio-general-value : Obtiene el valor general de su cartera
  Parameters: - chainId: Blockchain ID (default: 1/Ethereum)
• portfolio-value-chart : Obtiene datos gráficos del valor de la cartera a lo largo del tiempo
  Parameters: - chainId: Blockchain ID (default: 1/Ethereum)

Sistema de Monitoreo

La aplicación incluye un sistema de trabajo en segundo plano que supervisa y procesa las órdenes de intercambio:

Comandos del monitor

Cómo funciona el sistema de trabajo

1. Cuando se inicia un intercambio, la información del pedido se guarda en order-status.json
2. El demonio de monitorización comprueba continuamente si hay nuevos pedidos que necesiten supervisión.
3. Para cada nuevo pedido, se genera un proceso de trabajo dedicado.
4. El trabajador supervisa el estado del pedido y envía secretos cuando es necesario para completar el intercambio.
5. Una vez ejecutada una orden, el trabajador es dado de baja y se actualiza el estado.

Notas técnicas

• Creado con el SDK Cross-Chain de 1 pulgada para intercambios seguros entre cadenas
• Utiliza el protocolo de contexto de modelo para la integración del asistente de IA
• PrivateKeyProviderConnector en Fusion SDK es compatible con BlockchainProviderConnector
• La herramienta gestiona la gestión de secretos para la verificación de intercambio entre cadenas.