Datai MCP Server

Fornece dados de portfólio de carteira em tempo real, incluindo participações em DeFi, tokens e NFTs, usando a API Datai.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor Datai MCP

Datai Network

O Datai MCP permite que seu agente de IA entenda as participações DeFi, tokens e NFTs de uma carteira em segundos.

Seja você construindo com Eliza OS, Cursor ou qualquer stack de agente local — basta conectar um endereço de carteira, e o servidor MCP entrega contexto limpo e em tempo real, alimentado pela API Datai.

Perfeito para agentes de IA, plugins de LLM e desenvolvedores que precisam de acesso agêntico a dados de carteira.

O Datai MCP é um servidor MCP baseado em TypeScript que permite interação perfeita com os dados de portfólio de uma carteira por meio de interfaces alimentadas por IA, usando a mesma API por trás do motor de análise da Datai Network.

Recursos

8 Ferramentas DeFi Abrangentes: Cobertura completa das posições DeFi de uma carteira e análise de saldo de tokens
Suporte Multi-Cadeia: Ethereum, Arbitrum, Polygon, Avalanche, BSC, Base, Optimism e mais por vir
Suporte Multi-Protocolo – Centenas de protocolos DeFi
Configuração Rápida – Basta conectar o endereço da carteira, e o MCP entrega dados on-chain atualizados
Feito para Devs de IA – Integra-se com qualquer framework de agente compatível com MCP (Eliza, Cursor, Claude)
Dados em Tempo Real – Alimentado pelo pipeline de dados de carteira da API Datai
Amigável para Debug – Respostas truncadas para testes de desenvolvimento e exploração segura de memória
Tratamento de Erros: Gerenciamento e validação abrangentes de erros
Monitoramento de Performance: Medição de tempo de requisição e rastreamento de execução

Exemplo de Caso de Uso: Construindo um Copiloto de Carteira com IA

Você está criando um agente de IA que ajuda usuários a entender seu portfólio de criptomoedas. Com o Datai MCP:

Seu usuário conecta sua carteira.
Seu agente usa get_all_defi_positions para buscar a estratégia DeFi deles.
O agente resume as principais participações, sinaliza exposição a riscos e recomenda ações.

Tudo isso sem que você precise construir um indexador de blockchain.

Ferramentas Disponíveis

Recupere os dados do portfólio de uma carteira usando as seguintes ferramentas:

Ferramenta	Descrição	Parâmetros
`get_all_defi_positions`	Obter todas as posições DeFi em todas as cadeias suportadas	`wallet`
`get_defi_by_chain`	Obter posições DeFi para uma blockchain específica	`wallet`, `chain`
`get_defi_multi_chains`	Obter posições DeFi em múltiplas cadeias	`wallet`, `chains[]`
`get_defi_by_protocol`	Obter posições DeFi para um protocolo específico	`wallet`, `protocol`
`get_defi_balances_by_chain`	Obter saldos de protocolos DeFi por cadeia	`wallet`, `chain`
`get_overall_balance_all_c`	Obter saldo geral em todas as cadeias	`wallet`
`get_overall_balance_by_chain`	Obter saldo geral para uma cadeia específica	`wallet`, `chain`
`get_wallet_balances_by_chain`	Obter saldos de tokens para uma cadeia específica	`wallet`, `chain`

Dica: Use get_all_defi_positions para uma varredura completa do portfólio, ou ferramentas específicas por cadeia/protocolo para prompts direcionados.

Cadeias Suportadas

eth - Ethereum
arb - Arbitrum
matic - Polygon
avax - Avalanche
bsc - Binance Smart Chain
base - Base
op - Optimism
E mais por vir... acesse a lista de cadeias suportadas da Datai

Protocolos Suportados

Uniswap (V2, V3, V4)
Aave (V2, V3)
Compound
Balancer
SushiSwap
Curve
MakerDAO
E muitos outros... acesse a lista de protocolos suportados da Datai

Integração com Cursor

Para conectar ao servidor MCP a partir do Cursor:

Abra o Cursor e vá para Configurações (ícone de engrenagem no canto superior direito)
Clique em "MCP" na barra lateral esquerda
Clique em "Adicionar novo servidor MCP global"
Insira a seguinte configuração:

Configuração de Desenvolvimento 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"
      }
    }
  }
}

Configuração de Produção (NPX - Em Breve)

{
  "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"
      }
    }
  }
}

Variáveis de Ambiente

Variável	Descrição	Padrão	Obrigatório
`DATAI_API_KEY`	Sua chave de API Datai	-	✅ Sim
`DATAI_LIMIT`	Limite de resposta da API (1-100)	`10`	Não
`DATAI_DEBUG_TRUNCATE`	Ativar truncamento de dados para debug	`false`	Não
`DATAI_CONNECTION_TIMEOUT`	Timeout de conexão em ms	`130000`	Não
`DATAI_RESPONSE_TIMEOUT`	Timeout de resposta em ms	`90000`	Não
`DEBUG`	Ativar logging de debug	`false`	Não
`PORT`	Porta do servidor	`3099`	Não

Modo de Debug

Quando DATAI_DEBUG_TRUNCATE estiver definido como "true", o servidor truncará inteligentemente as respostas da API para evitar problemas de memória durante desenvolvimento e testes. Isso fornece:

Saída Mínima: Reduz respostas de 1000+ linhas para ~15 linhas
Preservação de Estrutura: Mostra tipos de dados, tamanhos de arrays, chaves de objetos
Dados de Amostra: Primeiros itens/valores para verificação
Status Claro: Indica quando o truncamento está ativo

Exemplo de saída 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"
}

Integração com Claude Desktop

Para conectar ao servidor MCP a partir do Claude Desktop:

Abra o Claude Desktop e vá para Configurações
Clique em "Desenvolvedor" na barra lateral esquerda
Clique no botão "Editar Config"
Adicione a configuração ao arquivo claude_desktop_config.json
Salve o arquivo e reinicie o Claude Desktop

Desenvolvimento Local

Pré-requisitos

Node.js v18 ou superior
npm ou yarn
Chave de API Datai - cadastre-se aqui para obter sua chave de API, é necessário endereço de e-mail

Início Rápido

Clone o repositório:

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

cd datai-fastmcp-server

Instale as dependências:

npm install

Compile o projeto:

npm run build

Configure seu cliente MCP com a configuração local mostrada acima
Comece a usar as ferramentas no seu cliente compatível com MCP!

Scripts Disponíveis

npm run build: Compilar o projeto TypeScript
npm run dev: Compilar e observar mudanças
npm run test: Executar suíte de testes (em breve)

Integração com API

Este servidor integra-se com a API Datai para fornecer dados de portfólio de carteira em tempo real:

URL Base: https://api-v1.mymerlin.io
Autenticação: Baseada em chave de API
Limite de Taxa: Configurável via DATAI_LIMIT
Tratamento de Timeout: Timeouts de conexão e resposta configuráveis
Tratamento de Erros: Transformação e registro abrangentes de erros

Cadastre-se aqui para obter sua chave de API Datai, é necessário endereço de e-mail.

Considerações de Segurança

Proteção da Chave de API: Nunca envie chaves de API para controle de versão
Variáveis de Ambiente: Use gerenciamento seguro de variáveis de ambiente
Validação de Entrada: Todas as entradas são validadas usando esquemas Zod
Sanitização de Erros: Informações sensíveis são filtradas das mensagens de erro
Proteção contra Timeout: Evita requisições penduradas com timeouts configuráveis

Nota Importante sobre Tamanho de Resposta e Compatibilidade com Agentes

O Datai MCP é projetado para enriquecer agentes de IA com dados de portfólio de carteira em tempo real (saldos de tokens, posições DeFi). No entanto, certas carteiras podem gerar respostas muito grandes, especialmente quando:

Mantêm dezenas ou centenas de tokens
Interagem com múltiplos protocolos DeFi
Usam muitas cadeias simultaneamente

Problemas Potenciais para Agentes de IA

A partir desta versão, as respostas não são resumidas. O conjunto completo de dados é retornado por padrão, a menos que seja truncado. Isso pode levar a problemas em ambientes de agentes, como:

Exceder limites de contexto do LLM (resultando em dados cortados ou ignorados)
Performance mais lenta ou tempo de raciocínio maior
Estouro de memória ou cota de tokens em ambientes hospedados
Comportamento confuso ou degradado do agente devido à sobrecarga de entrada

Recomendações

Até que resumo e consultas modulares estejam disponíveis, recomendamos:

Usar carteiras leves para testes e depuração
Filtrar ou resumir manualmente as respostas do MCP antes de injetá-las no seu agente
Manter o tamanho da resposta em mente ao projetar prompts ou gerenciar memória
Abrir uma issue ou entrar em contato conosco se quiser acesso antecipado a endpoints de resumo

Estamos melhorando ativamente a camada de compatibilidade com agentes - incluindo endpoints modulares e opções de resumo de dados nas próximas versões.

Contribuindo

Aceitamos contribuições! Por favor, garanta:

Todo o código segue as melhores práticas de TypeScript
Tratamento abrangente de erros é implementado
Validação de entrada está presente para todas as ferramentas
Logging é compatível com FastMCP
Testes são incluídos para novos recursos

Licença

Este projeto é licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

Sobre a Datai

A Datai está construindo a camada de dados agêntica para Web3. Fornecemos pipelines de dados de alta qualidade e em tempo real que alimentam agentes, copilotos de IA e protocolos inteligentes. O Datai MCP é um passo em nossa jornada para tornar os dados de carteira acessíveis, acionáveis e prontos para agentes.

Explore mais: https://datai.network

Feedback ou Suporte?

Estamos construindo isso para a comunidade de desenvolvedores de agentes e valorizamos muito sua contribuição:

Crie uma issue no repositório do GitHub
Consulte a documentação para soluções comuns
Revise a saída de debug quando DATAI_DEBUG_TRUNCATE=true