Crypto Price & Market Analysis

Fornece dados de preço de criptomoedas em tempo real, análise de mercado e tendências históricas usando a API CoinCap.

GitHub
39
Experimente este MCPPatrocinado

Documentação

Crypto Price & Market Analysis MCP Server

smithery badge NPM Downloads

Um servidor Model Context Protocol (MCP) que fornece análise abrangente de criptomoedas usando a API CoinCap. Este servidor oferece dados de preço em tempo real, análise de mercado e tendências históricas por meio de uma interface fácil de usar. Suporta transportes STDIO e HTTP Streamable.

Requisitos

  • Node.js 22.14+
  • Chave da API CoinCap via COINCAP_API_KEY

Novidades

  • BREAKING: A API CoinCap v2 foi removida. Agora usa exclusivamente a API v3. Uma COINCAP_API_KEY é necessária (plano gratuito disponível em pro.coincap.io/dashboard)
  • Transporte HTTP Streamable adicionado (mantendo compatibilidade com STDIO)
  • Scripts CLI Smithery para compilar e executar o servidor HTTP
  • 6 novas ferramentas: assets-search, market-global, assets-compare, analysis-candlestick, price-convert, assets-info
  • Nomenclatura hierárquica de ferramentas: Todas as ferramentas organizadas em nomes com prefixo de categoria (price-*, market-*, assets-*, analysis-*)
  • Esquemas de saída: Todas as ferramentas agora declaram outputSchema com structuredContent para respostas com segurança de tipos
  • Melhores práticas MCP: flag isError em erros de validação, descrição do servidor e template de recurso asset://{symbol}

Uso

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

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-crypto-price": {
      "command": "npx",
      "args": ["-y", "mcp-crypto-price"],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Se o seu cliente MCP exigir inicialização via cmd.exe no Windows:

{
  "mcpServers": {
    "mcp-crypto-price": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-crypto-price"],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Scripts de desenvolvimento

pnpm dev          # Development (HTTP server with hot reload via Smithery CLI)
pnpm build         # Compile TypeScript → dist/
pnpm format        # Format source files with Prettier
pnpm lint          # Check for lint errors (ESLint + typescript-eslint)
pnpm lint:fix      # Auto-fix lint errors
pnpm types:check   # TypeScript type-check without emitting files
pnpm test          # Run all tests with Vitest
pnpm test:coverage # Run tests with coverage report (Vitest)
pnpm inspector     # Open MCP inspector for interactive debugging

Executar como servidor HTTP Streamable

Você pode executar o servidor via HTTP para ambientes que suportam MCP sobre streaming HTTP.

  • Servidor de desenvolvimento (recomendado durante o desenvolvimento):
pnpm dev
  • Compilar e executar o servidor HTTP:
# Build (outputs to dist/)
pnpm build

# Start the HTTP server
pnpm start:http
  • Compilar e executar o servidor STDIO:
# Build (outputs to dist/)
pnpm build

# Start the STDIO server
pnpm start:stdio

O servidor escuta na porta 3000 por padrão (substitua com PORT). Para clientes que se conectam via HTTP (ex.: Smithery, Claude.ai), passe sua chave de API como parâmetro de consulta:

http://localhost:3000/mcp?COINCAP_API_KEY=YOUR_API_KEY_HERE

Para implantações remotas:

https://mcp-crypto-price.codemonkeyinnovations.com/mcp?COINCAP_API_KEY=YOUR_API_KEY_HERE

Obrigatório: Chave da API CoinCap

Este servidor usa a API CoinCap v3, que requer uma chave de API. Um plano gratuito está disponível.

  1. Cadastre-se e obtenha sua chave de API em pro.coincap.io/dashboard
  2. Adicione a chave à configuração do seu cliente MCP:
    • STDIO: via a variável de ambiente COINCAP_API_KEY (veja exemplos de Uso acima)
    • HTTP: via o parâmetro de consulta COINCAP_API_KEY na URL de conexão (ex.: /mcp?COINCAP_API_KEY=your_key)

Sem uma chave de API válida, todas as ferramentas retornarão um erro com instruções sobre como obter uma.

Nota para usuários do Smithery CLI

Este servidor MCP funciona diretamente via pnpm dlx (configurações acima) e não requer Smithery.

Se você usar o Smithery CLI, autentique-se com smithery auth login ou definindo SMITHERY_API_KEY no seu ambiente. Versões recentes do Smithery CLI não suportam passar chaves de API via --key (ou padrões mais antigos de --profile).

Inicie o Claude Desktop para começar a usar as ferramentas de análise de criptomoedas.

Ferramentas

price-get

Obtém preço atual e estatísticas de 24h para qualquer criptomoeda, incluindo:

  • Preço atual em USD
  • Variação de preço em 24 horas
  • Volume de negociação
  • Capitalização de mercado
  • Classificação de mercado

price-convert

Converte um valor de criptomoeda em qualquer moeda fiduciária:

  • Usa dados de preço em tempo real e taxas de câmbio baseadas em USD
  • Parâmetros: symbol (ex.: BTC), amount (padrão 1), currency (padrão usd)
  • Exemplo: 2,5 BTC em EUR

market-analysis

Fornece análise detalhada de mercado incluindo:

  • Top 5 exchanges por volume
  • Variações de preço entre exchanges
  • Análise de distribuição de volume
  • VWAP (Preço Médio Ponderado por Volume)

market-global

Fornece uma visão geral de todo o mercado de criptomoedas:

  • Capitalização de mercado total em todos os ativos
  • Volume de negociação em 24 horas
  • Número de criptomoedas ativas
  • Percentual de dominância do Bitcoin
  • Maiores altas e baixas

market-rates

Retorna taxas de conversão baseadas em USD para moedas fiduciárias e criptomoedas:

  • Todas as taxas de moedas fiduciárias (base USD)
  • Top 10 taxas de criptomoedas
  • Parâmetro opcional slug (ex.: euro, bitcoin) para consulta de uma única taxa

market-exchanges

Lista as principais exchanges de criptomoedas classificadas por volume em 24h:

  • Nome da exchange, classificação e volume em 24h em USD
  • Número de pares de negociação e percentual de participação de mercado
  • Parâmetro opcional exchangeId (ex.: binance) para detalhes de uma única exchange
  • Parâmetro opcional limit (1–50, padrão 10)

assets-top

Lista as principais criptomoedas classificadas por capitalização de mercado, incluindo:

  • Preço atual em USD
  • Variação de preço em 24 horas
  • Capitalização de mercado e classificação
  • Quantidade de resultados configurável (1–50, padrão 10)

assets-search

Busca criptomoedas por nome ou símbolo com correspondência difusa:

  • Retorna ativos correspondentes com símbolo, nome, preço e classificação
  • Quantidade de resultados configurável (1–50, padrão 10)
  • Exemplo: buscar "bit" retorna Bitcoin, Bitcoin Cash, BitTorrent, etc.

assets-info

Retorna metadados detalhados para uma única criptomoeda:

  • ID, classificação, símbolo e nome
  • Preço, variação em 24h, capitalização de mercado e volume
  • Oferta circulante e oferta máxima
  • VWAP (24h)

assets-compare

Compara 2–5 criptomoedas lado a lado:

  • Preço, variação em 24h, capitalização de mercado, volume e classificação para cada ativo
  • Símbolos separados por vírgula (ex.: BTC,ETH,SOL)
  • Destaca o melhor desempenho por variação em 24h

analysis-historical

Analisa dados históricos de preço com:

  • Intervalos de tempo personalizáveis (5min a 1 dia)
  • Suporte para até 30 dias de dados históricos
  • Análise de tendência de preço
  • Métricas de volatilidade
  • Faixas de preço máxima/mínima

analysis-technical

Retorna os indicadores técnicos mais recentes para qualquer criptomoeda:

  • SMA (Média Móvel Simples) com período
  • EMA (Média Móvel Exponencial) com período
  • RSI (Índice de Força Relativa) com sinal de Sobrecompra/Sobrevenda/Neutro
  • MACD com linha de sinal, histograma e rótulo de Alta/Baixa
  • VWAP (Preço Médio Ponderado por Volume, 24h)

analysis-candlestick

Recupera dados de candlestick OHLCV para uma criptomoeda:

  • Abertura, máxima, mínima, fechamento e volume para cada candle
  • Intervalo configurável (5m, 15m, 30m, 1h, 2h, 6h, 12h, 1d)
  • Suporta 1–30 dias de candles históricos

Recursos

O servidor expõe os seguintes recursos MCP:

  • info://server — Metadados de nome e versão do servidor
  • asset://{symbol} — Informações de ativo de criptomoeda por símbolo (ex.: asset://BTC), retornadas como JSON

Prompts

O servidor expõe os seguintes prompts MCP que os clientes podem invocar:

PromptArgsDescrição
analyze-cryptosymbolAnálise abrangente: preço, mercado, tendências históricas
compare-cryptocurrenciessymbolsComparar 2-5 criptos lado a lado
market-overview—Visão geral do mercado global: métricas, principais ativos, principais exchanges
crypto-conversionsymbol, amount?, currency?Converter valor de cripto para fiduciário
exchange-analysissymbolAnálise do cenário de exchanges para uma cripto
technical-analysissymbolAnálise técnica completa: indicadores, candles, tendências
crypto-screenerqueryBuscar e filtrar criptos por oportunidades

Exemplos de Prompts

  • "Qual é o preço atual do Bitcoin?"
  • "Mostre-me análise de mercado para ETH"
  • "Dê-me o histórico de preço de 7 dias para DOGE"
  • "Quais são as principais exchanges negociando BTC?"
  • "Mostre-me as tendências de preço para SOL com intervalos de 1 hora"
  • "Quais são os indicadores técnicos para ETH agora?"
  • "Qual é a taxa de câmbio atual de EUR para USD?"
  • "Quais exchanges de criptomoedas têm o maior volume em 24h?"
  • "Busque criptomoedas correspondentes a 'sol'"
  • "Dê-me uma visão geral do mercado de criptomoedas"
  • "Compare BTC, ETH e SOL lado a lado"
  • "Mostre-me dados de candlestick de 1 hora para BTC nos últimos 3 dias"
  • "Converta 2,5 BTC para EUR"
  • "Obtenha informações detalhadas sobre o ativo Ethereum"
  • "Gere uma análise abrangente de uma criptomoeda cobrindo preço, mercado e tendências históricas"
  • "Encontre todas as criptomoedas com 'bit' no nome e mostre-me seus preços atuais"
  • "Qual é a classificação de capitalização de mercado e a oferta circulante de Cardano?"
  • "Compare as 3 principais stablecoins e mostre qual tem o maior volume"
  • "Mostre-me como o Bitcoin se saiu nos últimos 30 dias com candles diários"
  • "Converta 100 SOL para GBP e mostre a taxa de câmbio"
  • "Dê-me uma visão completa do mercado: métricas globais, maiores altas e dominância do BTC"
  • "Quais são as criptos com melhor e pior desempenho nas últimas 24 horas?"
  • "Mostre-me dados de candlestick de 15 minutos para ETH nos últimos 2 dias"
  • "Compare tokens DeFi: UNI, AAVE, COMP e MKR"
  • "Qual é o VWAP e a oferta máxima do Bitcoin?"
  • "Busque tokens layer-2 e compare os principais resultados"

Licença

Este projeto é licenciado sob a Licença MIT