Datai MCP Server

Proporciona datos de cartera de billetera en tiempo real, incluyendo tenencias DeFi, tokens y NFT, utilizando la API de Datai.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor Datai MCP

Datai Network

Datai MCP permite que tu agente de IA comprenda las tenencias DeFi, de tokens y NFT de una wallet en segundos.

Ya sea que estés construyendo con Eliza OS, Cursor o cualquier stack de agentes local — simplemente conecta una dirección de wallet, y el servidor MCP entrega contexto limpio y en tiempo real impulsado por la API de Datai.

Perfecto para agentes de IA, plugins de LLM y desarrolladores que necesitan acceso agéntico a datos de wallet.

Datai MCP es un servidor MCP basado en TypeScript que permite una interacción fluida con los datos de portafolio de una wallet a través de interfaces impulsadas por IA, respaldado por la misma API detrás del motor de analítica de Datai Network.

Características

8 Herramientas DeFi Integrales: Cobertura completa de las posiciones DeFi de una wallet y análisis de saldos de tokens
Soporte Multi-Cadena: Ethereum, Arbitrum, Polygon, Avalanche, BSC, Base, Optimism y más por venir
Soporte Multi-Protocolo – Cientos de protocolos DeFi
Configuración Rápida – Solo conecta tu dirección de wallet, y el MCP entrega datos on-chain frescos
Construido para Desarrolladores de IA – Se integra con cualquier framework de agentes compatible con MCP (Eliza, Cursor, Claude)
Datos en Tiempo Real – Impulsado por el pipeline de datos de wallet de la API de Datai
Amigable para Depuración – Respuestas truncadas para pruebas de desarrollo y exploración segura de memoria
Manejo de Errores: Gestión y validación integral de errores
Monitoreo de Rendimiento: Seguimiento de tiempos de solicitud y ejecución

Caso de Uso de Ejemplo: Construyendo un Copiloto de Wallet con IA

Estás creando un agente de IA que ayuda a los usuarios a entender su portafolio cripto. Con Datai MCP:

Tu usuario conecta su wallet.
Tu agente usa get_all_defi_positions para obtener su estrategia DeFi.
El agente resume las tenencias clave, señala la exposición al riesgo y recomienda acciones.

Todo sin necesidad de que construyas un indexador de blockchain.

Herramientas Disponibles

Recupera los datos del portafolio de una wallet usando las siguientes herramientas:

Herramienta	Descripción	Parámetros
`get_all_defi_positions`	Obtén todas las posiciones DeFi en todas las cadenas compatibles	`wallet`
`get_defi_by_chain`	Obtén posiciones DeFi para una blockchain específica	`wallet`, `chain`
`get_defi_multi_chains`	Obtén posiciones DeFi en múltiples cadenas	`wallet`, `chains[]`
`get_defi_by_protocol`	Obtén posiciones DeFi para un protocolo específico	`wallet`, `protocol`
`get_defi_balances_by_chain`	Obtén saldos de protocolos DeFi por cadena	`wallet`, `chain`
`get_overall_balance_all_c`	Obtén el saldo general en todas las cadenas	`wallet`
`get_overall_balance_by_chain`	Obtén el saldo general para una cadena específica	`wallet`, `chain`
`get_wallet_balances_by_chain`	Obtén saldos de tokens para una cadena específica	`wallet`, `chain`

Consejo: Usa get_all_defi_positions para un escaneo completo del portafolio, o herramientas específicas de cadena/protocolo para consultas dirigidas.

Cadenas Compatibles

eth - Ethereum
arb - Arbitrum
matic - Polygon
avax - Avalanche
bsc - Binance Smart Chain
base - Base
op - Optimism
Y más por venir... accede a la lista de cadenas compatibles de Datai

Protocolos Compatibles

Uniswap (V2, V3, V4)
Aave (V2, V3)
Compound
Balancer
SushiSwap
Curve
MakerDAO
Y muchos más... accede a la lista de protocolos compatibles de Datai

Integración con Cursor

Para conectarte al servidor MCP desde Cursor:

Abre Cursor y ve a Configuración (ícono de engranaje en la esquina superior derecha)
Haz clic en "MCP" en la barra lateral izquierda
Haz clic en "Agregar nuevo servidor MCP global"
Ingresa la siguiente configuración:

Configuración de Desarrollo Local

{
  "mcpServers": {
    "datai-fastmcp-server-local": {
      "command": "node",
      "args": ["/path/to/your/datai-mcp/dist/index.js"],
      "env": {
        "DATAI_API_KEY": "your_api_key_here",
        "DATAI_LIMIT": "1",
        "DATAI_DEBUG_TRUNCATE": "true",
        "DATAI_CONNECTION_TIMEOUT": "130000",
        "DATAI_RESPONSE_TIMEOUT": "90000",
        "PORT": "3099",
        "DEBUG": "true",
        "NODE_ENV": "production",
        "MCP_DISABLE_PINGS": "true"
      }
    }
  }
}

Configuración de Producción (NPX - Próximamente)

{
  "mcpServers": {
    "datai-fastmcp-server": {
      "command": "npx",
      "args": ["-y", "datai-mcp-server@1.0.3"],
      "env": {
        "DATAI_API_KEY": "your_api_key_here",
        "DATAI_LIMIT": "1",
        "DATAI_DEBUG_TRUNCATE": "true",
        "DATAI_CONNECTION_TIMEOUT": "130000",
        "DATAI_RESPONSE_TIMEOUT": "90000",
        "PORT": "3099",
        "DEBUG": "true",
        "NODE_ENV": "production",
        "MCP_DISABLE_PINGS": "true"
      }
    }
  }
}

Variables de Entorno

Variable	Descripción	Predeterminado	Requerido
`DATAI_API_KEY`	Tu clave de API de Datai	-	✅ Sí
`DATAI_LIMIT`	Límite de respuesta de API (1-100)	`10`	No
`DATAI_DEBUG_TRUNCATE`	Habilita el truncamiento de datos para depuración	`false`	No
`DATAI_CONNECTION_TIMEOUT`	Tiempo de espera de conexión en ms	`130000`	No
`DATAI_RESPONSE_TIMEOUT`	Tiempo de espera de respuesta en ms	`90000`	No
`DEBUG`	Habilita el registro de depuración	`false`	No
`PORT`	Puerto del servidor	`3099`	No

Modo de Depuración

Cuando DATAI_DEBUG_TRUNCATE está configurado en "true", el servidor truncará inteligentemente las respuestas de la API para prevenir problemas de memoria durante el desarrollo y las pruebas. Esto proporciona:

Salida Mínima: Reduce respuestas de más de 1000 líneas a ~15 líneas
Preservación de Estructura: Muestra tipos de datos, longitudes de arrays, claves de objetos
Datos de Muestra: Primeros elementos/valores para verificación
Estado Claro: Indica cuándo el truncamiento está activo

Ejemplo de salida truncada:

{
  "__debug_truncated": true,
  "__summary": {
    "type": "array",
    "length": 25,
    "item_types": ["object"],
    "first_item_keys": ["chain", "name", "commonName", "logo", "site"]
  },
  "__sample_data": {
    "chain": "eth",
    "name": "uniswap3",
    "commonName": "Uniswap V3"
  },
  "__message": "✅ Tool working - data truncated for debugging"
}

Integración con Claude Desktop

Para conectarte al servidor MCP desde Claude Desktop:

Abre Claude Desktop y ve a Configuración
Haz clic en "Developer" en la barra lateral izquierda
Haz clic en el botón "Editar Config"
Agrega la configuración al archivo claude_desktop_config.json
Guarda el archivo y reinicia Claude Desktop

Desarrollo Local

Requisitos Previos

Node.js v18 o superior
npm o yarn
Clave de API de Datai - regístrate aquí para obtener tu clave de API, se requiere dirección de correo electrónico

Inicio Rápido

Clona el repositorio:

git clone https://github.com/Datai-Network/datai-fastmcp-server.git

cd datai-fastmcp-server

Instala las dependencias:

npm install

Compila el proyecto:

npm run build

Configura tu cliente MCP con la configuración local mostrada arriba
¡Comienza a usar las herramientas en tu cliente compatible con MCP!

Scripts Disponibles

npm run build: Compila el proyecto TypeScript
npm run dev: Compila y observa cambios
npm run test: Ejecuta el conjunto de pruebas (próximamente)

Integración de API

Este servidor se integra con la API de Datai para proporcionar datos de portafolio de wallet en tiempo real:

URL Base: https://api-v1.mymerlin.io
Autenticación: Basada en clave de API
Límite de Tasa: Configurable a través de DATAI_LIMIT
Manejo de Tiempos de Espera: Tiempos de espera de conexión y respuesta configurables
Manejo de Errores: Transformación y registro integral de errores

Regístrate aquí para obtener tu clave de API de Datai, se requiere dirección de correo electrónico.

Consideraciones de Seguridad

Protección de Clave de API: Nunca comprometas claves de API en control de versiones
Variables de Entorno: Usa gestión segura de variables de entorno
Validación de Entradas: Todas las entradas se validan usando esquemas Zod
Sanitización de Errores: La información sensible se filtra de los mensajes de error
Protección de Tiempos de Espera: Previene solicitudes colgadas con tiempos de espera configurables

Nota Importante sobre el Tamaño de Respuesta y Compatibilidad con Agentes

Datai MCP está diseñado para enriquecer agentes de IA con datos de portafolio de wallet en tiempo real (saldos de tokens, posiciones DeFi). Sin embargo, ciertas wallets pueden generar respuestas muy grandes, especialmente cuando:

Tienen docenas o cientos de tokens
Interactúan con múltiples protocolos DeFi
Usan muchas cadenas simultáneamente

Problemas Potenciales para Agentes de IA

A partir de esta versión, las respuestas no se resumen. El conjunto de datos completo se devuelve por defecto, a menos que se trunque. Esto puede causar problemas en entornos de agentes, como:

Exceder los límites de contexto del LLM (resultando en datos cortados o ignorados)
Rendimiento más lento o tiempo de razonamiento más largo
Exceder la memoria o cuota de tokens en entornos alojados
Comportamiento confuso o degradado del agente debido a sobrecarga de entrada

Recomendaciones

Hasta que el resumen y las consultas modulares estén disponibles, recomendamos:

Usar wallets ligeras para pruebas y depuración
Filtrar o resumir manualmente las respuestas del MCP antes de inyectarlas en tu agente
Tener en cuenta el tamaño de la respuesta al diseñar prompts o gestionar memoria
Abrir un issue o contactarnos si deseas acceso temprano a endpoints de resumen

Estamos mejorando activamente la capa de compatibilidad con agentes, incluidos endpoints modulares y opciones de resumen de datos en próximas versiones.

Contribuciones

¡Damos la bienvenida a contribuciones! Por favor, asegúrate de:

Todo el código sigue las mejores prácticas de TypeScript
Se implementa un manejo integral de errores
La validación de entradas está presente para todas las herramientas
El registro es compatible con FastMCP
Se incluyen pruebas para nuevas características

Licencia

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

Acerca de Datai

Datai está construyendo la capa de datos agéntica para Web3. Proporcionamos pipelines de datos de alta calidad y en tiempo real que impulsan agentes, copilotos de IA y protocolos inteligentes. Datai MCP es un paso en nuestro viaje para hacer que los datos de wallet sean accesibles, accionables y listos para agentes.

Explora más: https://datai.network

¿Comentarios o Soporte?

Estamos construyendo esto para la comunidad de desarrolladores de agentes y apreciamos mucho tu aporte:

Crea un issue en el repositorio de GitHub
Consulta la documentación para soluciones comunes
Revisa la salida de depuración cuando DATAI_DEBUG_TRUNCATE=true