Servidor MCP de intercambio entre cadenas de 1 pulgada

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 :

pnpm install
# or
yarn install

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.

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

DEV_PORTAL_KEY=replace_with_developer_portal_api_key
WALLET_ADDRESS=replace_with_wallet_address
WALLET_KEY=replace_with_wallet_private_key
RPC_URL_ETHEREUM=replace_with_ethereum_rpc_url
RPC_URL_BASE=replace_with_base_rpc_url
INCH_API_KEY=replace_with_1inch_api_key

Uso

Iniciar el servidor MCP

npm start

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

# Start the monitor daemon
npm run monitor:start

# Check status of all orders
npm run status

# Check status of monitor daemon
npm run monitor:status

# Stop the monitor daemon
npm run monitor:stop

Cómo funciona el sistema de trabajo

Cuando se inicia un intercambio, la información del pedido se guarda en order-status.json
El demonio de monitorización comprueba continuamente si hay nuevos pedidos que necesiten supervisión.
Para cada nuevo pedido, se genera un proceso de trabajo dedicado.
El trabajador supervisa el estado del pedido y envía secretos cuando es necesario para completar el intercambio.
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.

1inch Cross-Chain Swap MCP Server

Integrations