Web3 Research MCP

Uma ferramenta gratuita e local para pesquisa aprofundada em criptomoedas.

GitHub
162
Experimente este MCPPatrocinado

Documentação

Web3 Research MCP — deep research for crypto, free and fully local. An MCP server with 13 tools across CoinGecko, CoinMarketCap, DeFiLlama and more; no API key required.

Dê uma estrela para nós ❤️ → Star Web3 Research MCP on GitHub web3-research-mcp on npm @aaronjmars on X

Pesquisa aprofundada para cripto - gratuita e totalmente local.
Um servidor MCP local que pesquisa qualquer token em CoinGecko, CoinMarketCap, DeFiLlama e outros - sem chave de API, nada sai da sua máquina.

stars forks npm license

## 🚀 Prévia

Preview Preview2

🧠 Recursos

  • Pesquisa Abrangente: Reúna informações detalhadas sobre qualquer token de criptomoeda
  • Análise Multi-Fonte: Pesquise em várias fontes, incluindo CoinGecko, CoinMarketCap, DeFiLlama e outras
  • Relatórios Estruturados: Gere relatórios detalhados cobrindo fundamentos técnicos, dados de mercado, sentimento social e mais
  • Gerenciamento de Recursos: Armazena automaticamente resultados de pesquisa e conteúdo para referência
  • Acompanhamento de Status: Acompanhe o progresso da pesquisa em diferentes etapas e seções

📋 Requisitos

  • Node.js (v16 ou superior)

🔧 Instalação e Configuração

Instalando via Smithery

Para instalar web3-research-mcp para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install web3-research-mcp --client claude

🔌 Usando com Claude Desktop

Edite o arquivo de configuração do Claude Desktop

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

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

{
  "mcpServers": {
    "web3-research-mcp": {
      "command": "npx",
      "args": ["-y", "web3-research-mcp@latest"]
    }
  }
}

Em seguida, reinicie o Claude Desktop

🔌 Usando com Cursor

Vá para: Configurações -> Configurações do Cursor -> MCP -> Adicionar novo servidor MCP global. Cole isso no seu arquivo ~/.cursor/mcp.json do Cursor. Consulte a documentação do Cursor MCP para mais informações.

{
  "mcpServers": {
    "web3-research-mcp": {
      "command": "npx",
      "args": ["-y", "web3-research-mcp@latest"]
    }
  }
}

Em seguida, reinicie o Cursor

🛠️ Ferramentas

create-research-plan

Cria um plano de pesquisa estruturado para um token.

Parâmetros:

  • tokenName: Nome completo do token
  • tokenTicker: Símbolo do ticker do token

search

Realiza uma pesquisa na web e retorna os resultados.

Parâmetros:

  • query: Consulta de pesquisa
  • searchType: Tipo de pesquisa (web, notícias, imagens, vídeos)

research-with-keywords

Pesquisa um token com palavras-chave específicas e salva os resultados.

Parâmetros:

  • tokenName: Nome do token
  • tokenTicker: Símbolo do ticker
  • keywords: Matriz de palavras-chave para pesquisar

update-status

Atualiza o status de uma seção de pesquisa.

Parâmetros:

  • section: Nome da seção a ser atualizada (ex.: 'projectInfo', 'technicalFundamentals')
  • status: Novo status para a seção (planned, in_progress, completed)

fetch-content

Busca conteúdo de uma URL e o salva como recurso.

Parâmetros:

  • url: URL para buscar conteúdo
  • format: Formato de saída (text, html, markdown, json)

list-resources

Lista todos os recursos disponíveis que foram salvos.

search-source

Pesquisa informações sobre um token em uma fonte específica.

Parâmetros:

  • tokenName: Nome do token
  • tokenTicker: Símbolo do ticker
  • source: Fonte a ser pesquisada (ex.: 'CoinGecko', 'DeFiLlama', 'News')

research-source

Pesquisa uma fonte específica para um token e salva o conteúdo da página do melhor resultado como um recurso markdown.

Parâmetros:

  • tokenName: Nome do token
  • tokenTicker: Símbolo do ticker do token
  • source: Fonte a ser pesquisada (ex.: 'IQ Wiki', 'CoinMarketCap')

coingecko-data

Busca dados de mercado ao vivo diretamente da API pública do CoinGecko — preço, capitalização de mercado, variações de 24h/7d/30d, ATH/ATL, oferta circulante, endereços de contrato em várias redes e links sociais/de desenvolvimento. Contorna os problemas de 403 da raspagem de HTML.

Parâmetros:

  • tokenName: Nome completo do token (ex.: 'Bitcoin')
  • tokenTicker: Símbolo do ticker (ex.: 'BTC')

Nenhuma chave de API necessária. Usa o nível gratuito público (~30 req/min).

Opcional: defina COINGECKO_API_KEY no ambiente para usar uma chave de API Pro do CoinGecko. Quando definido, as solicitações são enviadas para https://pro-api.coingecko.com/api/v3 com o cabeçalho x-cg-pro-api-key. As solicitações expiram após 15s.

coingecko-search

Pesquisa o índice de moedas do CoinGecko e retorna correspondências candidatas com seus IDs do CoinGecko. Útil quando o ticker é ambíguo (ex.: vários tokens com o mesmo símbolo).

Parâmetros:

  • query: Consulta de pesquisa — nome, ticker ou endereço de contrato

coingecko-tickers

Busca listagens ativas em exchanges para um token do CoinGecko — quais CEXs/DEXs negociam o par, volume em USD de 24h por plataforma, último preço, spread de compra e venda, pontuação de confiança e URL de negociação. Classificado por volume em USD de 24h em ordem decrescente; anomalias e impressões desatualizadas são filtradas. Contorna a raspagem de HTML para a pergunta "onde esse token realmente é negociado".

Parâmetros:

  • tokenName: Nome completo do token (ex.: 'Bitcoin')
  • tokenTicker: Símbolo do ticker (ex.: 'BTC')
  • limit: Quantas principais plataformas retornar (padrão 15, máximo 50)

Nenhuma chave de API necessária. Usa o nível gratuito público. As solicitações expiram após 15s.

defillama-data

Busca dados de protocolo diretamente da API pública do DeFiLlama — TVL total, TVL máximo histórico com data, variação de TVL de 30/90/365 dias em relação ao atual, capitalização de mercado (quando disponível — o DeFiLlama a omite para muitos protocolos), detalhamento de TVL por rede, taxas (24h/7d/30d/todo o período), endereços de token, rodadas de captação e links. Contorna a raspagem de HTML para a consulta mais comum de protocolo DeFi.

Parâmetros:

  • tokenName: Nome completo do protocolo/token (ex.: 'Uniswap')
  • tokenTicker: Símbolo do ticker (ex.: 'UNI')

Nenhuma chave de API necessária. Usa a API pública gratuita. As solicitações expiram após 15s. O índice de protocolos é armazenado em cache por 5 minutos por processo para evitar sobrecarregar /protocols a cada chamada.

defillama-search

Pesquisa o índice de protocolos do DeFiLlama e retorna correspondências candidatas com seus slugs, TVL e categoria. Útil quando o ticker é ambíguo (ex.: vários protocolos com nomes semelhantes).

Parâmetros:

  • query: Consulta de pesquisa — nome do protocolo, ticker ou slug

📝 Prompts

token-research

Inicia uma pesquisa abrangente sobre um token de criptomoeda.

Parâmetros:

  • tokenName: Nome completo do token de criptomoeda
  • tokenTicker: Símbolo do ticker do token (ex.: BTC, ETH)

🧠 Como Funciona

  1. Quando a pesquisa começa, um plano estruturado é criado cobrindo todos os aspectos do token
  2. O servidor realiza pesquisas em várias fontes para obter informações
  3. Os resultados da pesquisa são armazenados como recursos que podem ser referenciados
  4. A pesquisa progride por diferentes seções, com acompanhamento de status
  5. Um relatório abrangente é gerado cobrindo todos os aspectos do token

⚠️ Limitações

  • Alguns sites bloqueiam a raspagem web, então a busca direta de conteúdo pode falhar com erros 403
  • Depende de resultados de pesquisa que podem nem sempre ser abrangentes
  • Limites de taxa podem ser aplicados às operações de pesquisa

📄 Licença

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

Construído por Aaron Elijah Mars, fundador da Aeon e MiroShark · @aaronjmars