EDUCHAIN Agent Kit

Este servidor MCP (Model Context Protocol) proporciona herramientas y recursos para interactuar con EDUCHAIN. Permite a Claude consultar información sobre tokens y pools y realizar swaps a través de SailFish DEX.

Características

Información de Tokens y Pools

• Obtener precios y detalles de tokens
• Obtener información y estadísticas de pools
• Ver datos históricos de tokens y pools
• Obtener los principales tokens y pools por TVL

Operaciones de Wallet

• Consultar saldos de EDU y tokens
• Obtener resúmenes de wallet incluyendo tokens y NFTs
• Enviar tokens EDU y ERC20

Operaciones de Swap

• Obtener cotizaciones de swap con impacto de precio e información de ruta
• Intercambiar tokens por tokens
• Intercambiar EDU por tokens (usando WEDU internamente)
• Intercambiar tokens por EDU (usando WEDU internamente)

Nota: SailFish DEX, al igual que otros forks de Uniswap v3, no admite swaps de tokens nativos directamente. En su lugar, utiliza WEDU (EDU Envuelto) internamente. Cuando usas las funciones de swap para EDU, el sistema maneja automáticamente el proceso de envoltura/desenvolvimiento, por lo que puedes trabajar directamente con EDU en tus transacciones. Si necesitas más control, también puedes usar las funciones wrap_edu y unwrap_wedu para convertir manualmente entre EDU y WEDU.

Operaciones de Arbitraje

• Obtener datos de mercado externos para EDU desde exchanges centralizados
• Verificar oportunidades de arbitraje entre CEX y SailFish DEX
• API de datos de mercado externos configurable
• Umbral de detección de arbitraje personalizable

Herramientas

Información de Tokens y Pools

• get_token_price: Obtener el precio actual de un token en SailFish DEX
• get_token_info: Obtener información detallada sobre un token en SailFish DEX
• get_pool_info: Obtener información detallada sobre un pool de liquidez en SailFish DEX
• get_top_tokens: Obtener una lista de los principales tokens por TVL en SailFish DEX
• get_top_pools: Obtener una lista de los principales pools de liquidez por TVL en SailFish DEX
• get_total_tvl: Obtener el valor total bloqueado (TVL) en SailFish DEX
• get_24h_volume: Obtener el volumen de trading de 24 horas en SailFish DEX
• get_token_historical_data: Obtener datos históricos de un token en SailFish DEX
• get_pool_historical_data: Obtener datos históricos de un pool de liquidez en SailFish DEX

Operaciones de Wallet

• get_edu_balance: Obtener el saldo de EDU de una dirección de wallet
• get_token_balance: Obtener el saldo de tokens de una dirección de wallet con valor en USD
• get_multiple_token_balances: Obtener múltiples saldos de tokens para una dirección de wallet
• get_nft_balance: Obtener el saldo de NFTs de una dirección de wallet para una colección NFT específica
• get_wallet_overview: Obtener un resumen de una wallet incluyendo EDU, tokens y NFTs
• get_wallet_address_from_private_key: Obtener la dirección de wallet desde la clave privada
• send_edu: Enviar el token nativo EDU a otra dirección de wallet
• send_erc20_token: Enviar un token ERC20 a otra dirección de wallet

Operaciones de Swap

• get_swap_quote: Obtener una cotización para intercambiar tokens en SailFish DEX
• swap_tokens: Intercambiar tokens en SailFish DEX (token por token)
• swap_edu_for_tokens: Intercambiar EDU por tokens en SailFish DEX
• swap_tokens_for_edu: Intercambiar tokens por EDU en SailFish DEX
• wrap_edu: Envolver EDU a WEDU (EDU Envuelto)
• unwrap_wedu: Desenvolver WEDU (EDU Envuelto) a EDU

Operaciones de Arbitraje

• get_external_market_data: Obtener datos de mercado externos para EDU desde exchanges centralizados
• check_arbitrage_opportunities: Verificar oportunidades de arbitraje entre CEX y SailFish DEX
• update_external_market_config: Actualizar la configuración de la API de datos de mercado externos
• get_external_market_config: Obtener la configuración actual de la API de datos de mercado externos

Configuración

• set_rpc_url: Establecer la URL RPC para interacciones con blockchain
• get_rpc_url: Obtener la URL RPC actual utilizada para interacciones con blockchain

Recursos

• sailfish://overview: Resumen de SailFish DEX incluyendo TVL, volumen y otras métricas
• sailfish://token/{tokenId}: Información sobre un token específico en SailFish DEX
• sailfish://pool/{poolId}: Información sobre un pool de liquidez específico en SailFish DEX

Instalación

1. Asegúrate de tener Node.js instalado
2. Clona este repositorio
3. Instala las dependencias:

   npm install
   

4. Compila el proyecto:

   npm run build
   

5. Añade el servidor MCP a tu archivo de configuración de Claude Desktop:

   {
     "mcpServers": {
       "sailfish": {
         "command": "node",
         "args": ["/path/to/SubgraphMCP/build/index.js"],
         "env": {
           "RPC_URL": "https://your-edu-rpc-url.com"
         }
       }
     }
   }
   

Ejemplos de Uso

Obtener Precio de Token

use_mcp_tool("sailfish", "get_token_price", {
  "tokenId": "0x836d275563bAb5E93Fd6Ca62a95dB7065Da94342"
});

Obtener Cotización de Swap

use_mcp_tool("sailfish", "get_swap_quote", {
  "tokenIn": "0xd02E8c38a8E3db71f8b2ae30B8186d7874934e12",
  "tokenOut": "0x836d275563bAb5E93Fd6Ca62a95dB7065Da94342",
  "amountIn": "10"
});

Intercambiar Tokens

use_mcp_tool("sailfish", "swap_tokens", {
  "privateKey": "YOUR_PRIVATE_KEY",
  "tokenIn": "0xd02E8c38a8E3db71f8b2ae30B8186d7874934e12",
  "tokenOut": "0x836d275563bAb5E93Fd6Ca62a95dB7065Da94342",
  "amountIn": "10",
  "slippagePercentage": 0.5
});

Verificar Oportunidades de Arbitraje

use_mcp_tool("sailfish", "check_arbitrage_opportunities", {
  "threshold": 1.5
});

Actualizar Configuración de API de Mercado Externo

use_mcp_tool("sailfish", "update_external_market_config", {
  "apiUrl": "https://api.example.com/crypto/prices",
  "apiKey": "YOUR_API_KEY",
  "symbols": {
    "EDU": "EDU",
    "USD": "USDT"
  }
});

Envolver EDU a WEDU

use_mcp_tool("sailfish", "wrap_edu", {
  "privateKey": "YOUR_PRIVATE_KEY",
  "amount": "10"
});

Desenvolver WEDU a EDU

use_mcp_tool("sailfish", "unwrap_wedu", {
  "privateKey": "YOUR_PRIVATE_KEY",
  "amount": "10"
});

Pruebas

Puedes ejecutar el script de prueba para verificar la funcionalidad:

node build/test.js

Esto probará la funcionalidad de enrutamiento y cotización de swap sin ejecutar swaps reales.

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.