DeAI API MCP Server

Servidor MCP da API DeAI

Um servidor Model Context Protocol (MCP) que fornece ferramentas para interagir com a API DeAI para análise de tokens, rastreamento de detentores e análise de carteiras na Ethereum.

Recursos

O servidor MCP expõe as seguintes ferramentas para análises (atualmente suporta ETH):

• get_token_info - Obtenha informações detalhadas do token, incluindo nome, símbolo, decimais, logotipo e imposto do token
• get_top_holders - Analise os detentores de qualquer token com seus saldos e percentuais
• get_token_holder_balance_changes - Acompanhe as mudanças de saldo dos detentores de tokens nos últimos 7 dias
• get_portfolio - Obtenha dados abrangentes de portfólio para qualquer carteira, incluindo valor total, mudanças e participações em tokens

Início Rápido

Pré-requisitos

• Node.js 18+
• Chave da API DeAI - Obtenha uma em https://t.me/DeCenterAIDev

Instalação

1. Clone o repositório:

   git clone https://github.com/decenterailab/deai-api-mcp-server.git
   cd deai-api-mcp-server
   

2. Instale as dependências:

   npm install
   

3. Defina sua chave de API:

   export API_KEY="your_api_key_here"
   

4. Teste o servidor:

   npm test
   

5. Inicie o servidor:

   npm start
   

Configuração

Variáveis de Ambiente

• API_KEY (obrigatório) - Sua chave de API

Integração com Claude Desktop

Adicione esta configuração ao arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "deai-api": {
      "command": "node",
      "args": ["/your_path/deai-api-mcp-server/src/server.js"],
      "env": {
        "API_KEY": "your_api_key"
      }
    }
  }
}

Exemplos Básicos de Uso

Análise de Token

Get token information for 0x5FC111f3Fa4C6b32eAf65659CFEbdeed57234069

Análise de Detentores

Show me the top holders of token 0x5FC111f3Fa4C6b32eAf65659CFEbdeed57234069

Rastreamento de Saldo

Get balance changes for token holders of 0x5FC111f3Fa4C6b32eAf65659CFEbdeed57234069 over the last 7 days

Análise de Portfólio

Get portfolio data for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

🛠️ Desenvolvimento

Estrutura do Projeto

deai-api-mcp-server/
├── src/
│   └── server.js          # Main MCP server implementation
├── package.json           # Dependencies and scripts
├── example.env           # Environment template
└── README.md             # This file

Segurança

• As chaves de API são passadas por variáveis de ambiente
• Nenhum dado sensível é registrado ou armazenado
• As solicitações de rede usam fetch integrado com proteção de tempo limite
• Validação de entrada usando esquemas Zod

Referência da API

Endpoints Suportados

• Informações do Token: /api/token/token-info/{contractAddress}
• Principais Detentores: /api/token/top-holders/{contractAddress}
• Mudanças de Saldo: /api/token/token-holder-balance-changes/{contractAddress}
• Portfólio: /api/token/portfolio/{walletAddress}

Redes Suportadas

• Ethereum Mainnet (principal)

Limites de Taxa

Os limites de taxa dependem do nível da sua chave de API:

• Standard: 2 solicitações/segundo, 10.000 créditos
• Pro: 5 solicitações/segundo, 50.000 créditos
• Enterprise: créditos personalizados

Solução de Problemas

Problemas Comuns

1. "A variável de ambiente API_KEY é obrigatória"

export API_KEY="your_api_key"

2. "Erro de rede: não foi possível acessar a API DeAI"

• Verifique sua conexão com a internet
• Verifique se o endpoint da API está acessível
• Certifique-se de que a chave da API seja válida

3. "Erro da API (401): Não autorizado"

• Verifique se sua chave de API está correta
• Verifique se sua chave de API expirou
• Certifique-se de que há créditos suficientes

4. Claude Desktop não encontra o servidor

• Use caminhos absolutos na configuração
• Certifique-se de que o diretório de trabalho esteja definido corretamente
• Reinicie o Claude Desktop após alterações na configuração