DeAI API MCP Server

Interactúa con la API de DeAI para análisis de tokens, seguimiento de tenedores y análisis de carteras en Ethereum.

Documentación

Servidor MCP de la API DeAI

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para interactuar con la API de DeAI para análisis de tokens, seguimiento de tenedores y analíticas de carteras en Ethereum.

Características

El servidor MCP expone las siguientes herramientas para analíticas (Actualmente soporta ETH):

get_token_info - Obtén información detallada del token, incluyendo nombre, símbolo, decimales, logo e impuestos del token
get_top_holders - Analiza los tenedores de cualquier token con sus saldos y porcentajes
get_token_holder_balance_changes - Rastrea los cambios de saldo de los tenedores de tokens durante los últimos 7 días
get_portfolio - Obtén datos completos de la cartera de cualquier wallet, incluyendo valor total, cambios y tenencias de tokens

Inicio Rápido

Requisitos Previos

Node.js 18+
Clave de API de DeAI - Obtén una en https://t.me/DeCenterAIDev

Instalación

Clona el repositorio:

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

Instala las dependencias:
```
npm install
```
Configura tu clave de API:
```
export API_KEY="your_api_key_here"
```
Prueba el servidor:
```
npm test
```
Inicia el servidor:
```
npm start
```

Configuración

Variables de Entorno

API_KEY (obligatorio) - Tu clave de API

Integración con Claude Desktop

Añade esta configuración al archivo de configuración de 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"
      }
    }
  }
}

Ejemplos Básicos de Uso

Análisis de Tokens

Get token information for 0x5FC111f3Fa4C6b32eAf65659CFEbdeed57234069

Análisis de Tenedores

Show me the top holders of token 0x5FC111f3Fa4C6b32eAf65659CFEbdeed57234069

Seguimiento de Saldos

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

Análisis de Cartera

Get portfolio data for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

🛠️ Desarrollo

Estructura del Proyecto

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

Seguridad

Las claves de API se pasan mediante variables de entorno
No se registran ni almacenan datos sensibles
Las solicitudes de red utilizan fetch integrado con protección de tiempo de espera
Validación de entrada mediante esquemas Zod

Referencia de la API

Endpoints Soportados

Información del Token: /api/token/token-info/{contractAddress}
Principales Tenedores: /api/token/top-holders/{contractAddress}
Cambios de Saldo: /api/token/token-holder-balance-changes/{contractAddress}
Cartera: /api/token/portfolio/{walletAddress}

Redes Soportadas

Red Principal de Ethereum (principal)

Límites de Tasa

Los límites de tasa dependen del nivel de tu clave de API:

Estándar: 2 solicitudes/segundo, 10,000 créditos
Pro: 5 solicitudes/segundo, 50,000 créditos
Empresarial: créditos personalizados

Solución de Problemas

Problemas Comunes

1. "Se requiere la variable de entorno API_KEY"

export API_KEY="your_api_key"

2. "Error de red: No se puede acceder a la API de DeAI"

Verifica tu conexión a internet
Confirma que el endpoint de la API sea accesible
Asegúrate de que la clave de API sea válida

3. "Error de API (401): No autorizado"

Verifica que tu clave de API sea correcta
Comprueba si tu clave de API ha expirado
Asegúrate de que queden créditos suficientes

4. Claude Desktop no encuentra el servidor

Usa rutas absolutas en la configuración
Asegúrate de que el directorio de trabajo esté configurado correctamente
Reinicia Claude Desktop después de los cambios de configuración