EDUCHAIN Agent Kit

Este servidor MCP (Model Context Protocol) fornece ferramentas e recursos para interagir com a EDUCHAIN. Ele permite que o Claude consulte informações sobre tokens e pools e realize swaps através da SailFish DEX.

Recursos

Informações sobre Tokens e Pools

• Obter preços e detalhes de tokens
• Obter informações e estatísticas de pools
• Visualizar dados históricos de tokens e pools
• Obter os principais tokens e pools por TVL

Operações de Carteira

• Verificar saldos de EDU e tokens
• Obter visões gerais da carteira, incluindo tokens e NFTs
• Enviar tokens EDU e ERC20

Operações de Swap

• Obter cotações de swap com impacto de preço e informações de rota
• Trocar tokens por tokens
• Trocar EDU por tokens (usando WEDU internamente)
• Trocar tokens por EDU (usando WEDU internamente)

Nota: A SailFish DEX, como outros forks do Uniswap v3, não suporta swaps de tokens nativos diretamente. Em vez disso, ela usa WEDU (EDU Envolvido) internamente. Quando você usa as funções de swap para EDU, o sistema lida automaticamente com o processo de envolvimento/desenvolvimento, permitindo que você trabalhe diretamente com EDU em suas transações. Se precisar de mais controle, você também pode usar as funções wrap_edu e unwrap_wedu para converter manualmente entre EDU e WEDU.

Operações de Arbitragem

• Obter dados de mercado externos para EDU de exchanges centralizadas
• Verificar oportunidades de arbitragem entre CEX e SailFish DEX
• API de dados de mercado externo configurável
• Limite de detecção de arbitragem personalizável

Ferramentas

Informações sobre Tokens e Pools

• get_token_price: Obter o preço atual de um token na SailFish DEX
• get_token_info: Obter informações detalhadas sobre um token na SailFish DEX
• get_pool_info: Obter informações detalhadas sobre um pool de liquidez na SailFish DEX
• get_top_tokens: Obter uma lista dos principais tokens por TVL na SailFish DEX
• get_top_pools: Obter uma lista dos principais pools de liquidez por TVL na SailFish DEX
• get_total_tvl: Obter o valor total bloqueado (TVL) na SailFish DEX
• get_24h_volume: Obter o volume de negociação de 24 horas na SailFish DEX
• get_token_historical_data: Obter dados históricos de um token na SailFish DEX
• get_pool_historical_data: Obter dados históricos de um pool de liquidez na SailFish DEX

Operações de Carteira

• get_edu_balance: Obter o saldo de EDU de um endereço de carteira
• get_token_balance: Obter o saldo de tokens de um endereço de carteira com valor em USD
• get_multiple_token_balances: Obter múltiplos saldos de tokens para um endereço de carteira
• get_nft_balance: Obter o saldo de NFTs de um endereço de carteira para uma coleção específica de NFTs
• get_wallet_overview: Obter uma visão geral de uma carteira, incluindo EDU, tokens e NFTs
• get_wallet_address_from_private_key: Obter endereço de carteira a partir de chave privada
• send_edu: Enviar token nativo EDU para outro endereço de carteira
• send_erc20_token: Enviar token ERC20 para outro endereço de carteira

Operações de Swap

• get_swap_quote: Obter uma cotação para trocar tokens na SailFish DEX
• swap_tokens: Trocar tokens na SailFish DEX (token para token)
• swap_edu_for_tokens: Trocar EDU por tokens na SailFish DEX
• swap_tokens_for_edu: Trocar tokens por EDU na SailFish DEX
• wrap_edu: Envolver EDU para WEDU (EDU Envolvido)
• unwrap_wedu: Desenvolver WEDU (EDU Envolvido) para EDU

Operações de Arbitragem

• get_external_market_data: Obter dados de mercado externos para EDU de exchanges centralizadas
• check_arbitrage_opportunities: Verificar oportunidades de arbitragem entre CEX e SailFish DEX
• update_external_market_config: Atualizar a configuração da API de dados de mercado externo
• get_external_market_config: Obter a configuração atual da API de dados de mercado externo

Configuração

• set_rpc_url: Definir a URL RPC para interações com blockchain
• get_rpc_url: Obter a URL RPC atual usada para interações com blockchain

Recursos

• sailfish://overview: Visão geral da SailFish DEX, incluindo TVL, volume e outras métricas
• sailfish://token/{tokenId}: Informações sobre um token específico na SailFish DEX
• sailfish://pool/{poolId}: Informações sobre um pool de liquidez específico na SailFish DEX

Instalação

1. Certifique-se de ter o Node.js instalado
2. Clone este repositório
3. Instale as dependências:

   npm install
   

4. Compile o projeto:

   npm run build
   

5. Adicione o servidor MCP ao arquivo de configuração do Claude Desktop:

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

Exemplos de Uso

Obter Preço de Token

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

Obter Cotação de Swap

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

Trocar Tokens

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

Verificar Oportunidades de Arbitragem

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

Atualizar Configuração da 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 para WEDU

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

Desenvolver WEDU para EDU

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

Testes

Você pode executar o script de teste para verificar a funcionalidade:

node build/test.js

Isso testará a funcionalidade de roteamento e cotação de swap sem executar swaps reais.

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.