CryptoAnalysisMCP

Fornece análise técnica abrangente de criptomoedas, incluindo dados de preço em tempo real, indicadores técnicos, detecção de padrões gráficos e sinais de negociação para mais de 2.500 criptomoedas.

GitHub

Experimente este MCPPatrocinado

Documentação

CryptoAnalysisMCP v1.3 🚀

Suporta mais de 7 MILHÕES de tokens através da integração com DexPaprika! 🎉

Um servidor MCP (Model Context Protocol) para análise técnica abrangente de criptomoedas. Construído com Swift, fornece dados de preço em tempo real, indicadores técnicos, detecção de padrões gráficos e sinais de negociação para mais de 7 milhões de criptomoedas — do Bitcoin à mais nova meme coin em qualquer DEX!

⚠️ IMPORTANTE PARA DAY TRADERS: Esta ferramenta requer uma assinatura Pro de US$ 99/mês para análise intradiária. O plano gratuito suporta apenas candles diários, sendo adequado apenas para swing traders e investidores de longo prazo.

⚠️ Aviso Legal

O CryptoAnalysisMCP é fornecido apenas para fins informativos e educacionais. Não é aconselhamento financeiro, de investimento, de negociação ou fiscal, e nada do que ele produz deve ser tratado como uma recomendação para comprar, vender ou manter qualquer ativo.

Indicadores técnicos, padrões gráficos e sinais de negociação são calculados a partir de dados públicos de mercado usando fórmulas conhecidas. Eles são imperfeitos, podem estar errados e não oferecem garantia preditiva.
Os mercados de criptomoedas são altamente voláteis. Você pode perder todo o seu investimento — e mais do que investiu se usar alavancagem ou margem. Nunca negocie com dinheiro que você não pode perder.
Desempenho passado — incluindo quaisquer exemplos, backtests ou saídas de amostra neste repositório — não prevê retornos futuros.
O autor e os colaboradores não são consultores financeiros licenciados. Este projeto não é afiliado, endossado ou operado por qualquer exchange, corretora, regulador ou provedor de dados.
Sempre faça sua própria pesquisa (DYOR), consulte um profissional financeiro qualificado sobre sua situação específica e verifique qualquer dado produzido por esta ferramenta contra uma fonte autoritativa antes de agir.
O software é fornecido "como está", sem garantia de qualquer tipo, conforme a Licença MIT. O autor e os colaboradores não são responsáveis por quaisquer perdas, danos ou consequências decorrentes do uso desta ferramenta.

Ao usar o CryptoAnalysisMCP, você reconhece e aceita estes termos. Consulte DISCLAIMER.md para o texto completo.

🆕 Novidades na v1.3

🔄 Transporte Padrão do SDK

Migrado do SimpleMCP interno para o mcp-swift-sdk oficial v0.12.1 como transporte padrão
SimpleMCP legado disponível via flag --use-legacy (válvula de segurança de uma versão; removido na v1.4)
Ambos os transportes expõem as mesmas 16 ferramentas com esquemas idênticos

⚙️ Toolchain Swift 6.1

Conformidade total com concorrência estrita, com zero avisos
Padrões modernos de async/await em todo o código
Segurança de tipos e gerenciamento de memória aprimorados

📦 Pacote de Qualidade v1.2

Protocolo DataProvider para fontes de dados plugáveis (CoinPaprika primária, DexPaprika como fallback)
Precisão matemática corrigida em todos os indicadores técnicos (RSI, MACD, OBV, Williams %R, Bandas de Bollinger)
Mais de 2.989 testes de integração e golden-vector garantem a precisão dos indicadores

🐦 Siga @m_pineapple__ para atualizações!

Recursos

💡 Não sabe o que perguntar? Consulte nosso Guia de Prompts de Análise de Cripto para se inspirar!

Suporte Universal a Tokens: Mais de 7 MILHÕES de tokens através da integração com DexPaprika
Análise de Pools de Liquidez: Monitore liquidez, volume e dados de pools em DEXes
Resolução Dinâmica de Símbolos: Suporta automaticamente todas as criptomoedas
Dados de Preço em Tempo Real: Preços atuais, volume, capitalização de mercado e variações percentuais
Indicadores Técnicos: RSI, MACD, Médias Móveis, Bandas de Bollinger e mais
Detecção de Padrões Gráficos: Ombro-cabeça-ombro, triângulos, topos e fundos duplos
Níveis de Suporte e Resistência: Identificação automática de níveis de preço-chave
Sinais de Negociação: Recomendações de compra/venda/manutenção baseadas em análise técnica
Análise Multi-timeframe: Timeframes de 4 horas, diário, semanal e mensal
Filtragem de Sinais Ajustada ao Risco: Limiares conservadores, moderados e agressivos para confiança do sinal

🗺️ Roadmap

v1.4 (Planejado)

Remover o transporte SimpleMCP legado (o SDK se torna obrigatório)

Quer sugerir um recurso? Abra uma issue no GitHub!

❓ Perguntas Frequentes

Preciso de uma chave de API paga para usar este MCP?

Resposta curta: Depende do seu estilo de negociação.

⚠️ IMPORTANTE: Day traders e scalpers PRECISAM de uma assinatura Pro (US$ 99/mês). O plano gratuito fornece apenas candles diários, o que é inútil para negociação intradiária.

O que funciona SEM chave de API:

✅ Dados de preço em tempo real (com pequenos atrasos)
✅ Análise de swing trading (negociações de 3 a 7 dias)
✅ Negociação de posição (semanas a meses)
✅ Análise de investimento de longo prazo
✅ Todos os indicadores técnicos no timeframe DIÁRIO
✅ 1 ano de dados históricos diários
Dados básicos de preço para mais de 7 MILHÕES de tokens via DexPaprika
Dados de pools de liquidez em todos os principais DEXes
Comparação e agregação de preços em DEXes

O que REQUER uma chave de API Pro (US$ 99/mês):

❌ Day trading (você precisa de dados horários/4h)
❌ Scalping (você precisa de dados de minutos)
❌ Padrões e sinais intradiários
❌ Atualizações em tempo real/baixa latência
❌ Dados históricos além de 1 ano
❌ Qualquer timeframe menor que diário

Como obter sua chave de API GRATUITA:

Acesse CoinPaprika API
Clique em "Start Free"
Registre-se para criar uma conta
Obtenha sua chave de API
Adicione à configuração do Claude Desktop:

{
  "mcpServers": {
    "crypto-analysis": {
      "command": "/path/to/crypto-analysis-mcp",
      "env": {
        "COINPAPRIKA_API_KEY": "your-free-api-key-here"
      }
    }
  }
}

O plano gratuito inclui:

✅ 25.000 chamadas de API por mês
✅ 1 ano de dados históricos diários
✅ Mais de 2.500 criptomoedas

Para recursos avançados, faça upgrade para CoinPaprika Pro:

❌ Timeframes de 4 horas e horários (Pro necessário)
❌ Dados históricos estendidos além de 1 ano
❌ Limites de taxa mais altos
❌ Suporte prioritário

Posso usar a API do CoinMarketCap ou CoinGecko em vez disso?

Atualmente: Não implementado. O CryptoAnalysisMCP usa CoinPaprika como provedor de dados principal.

Como adicionar suporte: A partir da v1.2.0, o protocolo DataProvider torna simples adicionar fontes de dados alternativas. Se você está interessado na integração com CoinMarketCap ou CoinGecko, contribuições são bem-vindas! Abra uma issue para discutir ou envie um PR.

Por que CoinPaprika primeiro:

3x mais cobertura de mercado que concorrentes (mais de 71.000 ativos)
Plano gratuito mais generoso (25.000 chamadas de API/mês)
Melhor acesso a dados históricos
Confiabilidade superior da API (99,9% de uptime)

Quais criptomoedas são suportadas?

O MCP suporta mais de 7 MILHÕES de tokens via integração com DexPaprika:

✅ Todos os mais de 2.500 tokens CoinPaprika (moedas principais com análise completa)
✅ Mais de 7 MILHÕES de tokens DEX via DexPaprika (fallback automático)
✅ Todo token em todo DEX em mais de 23 blockchains
✅ Tokens recém-lançados — analise tokens minutos após o lançamento
✅ Meme coins obscuras — se negocia em um DEX, nós temos
✅ NENHUMA CHAVE DE API NECESSÁRIA para dados básicos de preço

Exemplos:

Moedas principais: BTC, ETH, SOL (análise técnica completa via CoinPaprika)
Memes populares: DOGE, SHIB, PEPE, WOJAK (dados de preço de qualquer fonte)
Novos lançamentos: Aquele token lançado há 5 minutos na Uniswap
Qualquer token ERC-20, BEP-20, SPL ou token em qualquer chain suportada

Basta usar o símbolo do ticker — o MCP o encontra automaticamente!

Por que estou recebendo erros de 402 Payment Required?

Você está tentando usar recursos que exigem uma assinatura Pro:

Causas comuns:

Usar qualquer timeframe diferente de 'daily' (4h, 1h, 15m, etc.)
Solicitar dados mais antigos que 1 ano
Exceder limites de taxa (raro)

Soluções:

Para swing trading/investimento: Basta usar o timeframe 'daily' — é gratuito!
Para day trading: Você DEVE fazer upgrade para CoinPaprika Pro (US$ 99/mês)

NÃO existe opção gratuita para day trading. Se você precisa de dados intradiários, precisa pagar.

Quão precisos são os sinais de negociação?

Os sinais de negociação são apenas para fins informativos — consulte o Aviso Legal no topo deste README e o DISCLAIMER.md completo. Eles são baseados em indicadores técnicos bem estabelecidos, mas nenhuma previsão é 100% precisa. Sempre faça sua própria pesquisa e nunca invista mais do que pode perder.

Posso usar isso para negociação automatizada?

Embora tecnicamente possível, recomendamos fortemente cautela:

Este MCP fornece análise, não execução
Requer mecanismos de segurança adicionais
Precisa de gerenciamento de risco adequado
Deve ser completamente backtestado
Considere paper trading primeiro

Com que frequência os dados são atualizados?

Depende do seu nível de API:

Plano gratuito: Atrasos de ~1-5 minutos
Plano Pro: Atualizações de preços a cada 30 segundos
Cache local: 1-5 minutos para reduzir chamadas de API

Minha chave de API é segura?

Sim! Sua chave de API:

Nunca é hardcoded
Apenas lida de variáveis de ambiente
Nunca é registrada ou transmitida
Apenas usada para chamadas à API CoinPaprika
Segue as melhores práticas de segurança

Posso contribuir com este projeto?

Absolutamente! Aceitamos contribuições:

Correções de bugs
Novos indicadores
Melhorias de desempenho
Atualizações de documentação
Sugestões de recursos

Consulte nossa seção Contribuindo para diretrizes.

Onde posso obter ajuda?

Verifique este FAQ primeiro
Leia a documentação
Pesquise issues existentes
Abra uma nova issue com detalhes
Participe das discussões da comunidade

Por que Swift em vez de Python/JavaScript?

Swift oferece:

Desempenho nativo do macOS
Segurança de tipos e concorrência moderna
Excelente gerenciamento de memória
Integração perfeita com Claude Desktop
Ecossistema crescente para desenvolvimento server-side

Além disso, amamos Swift! 🍍

Pré-requisitos

macOS 10.15 ou posterior
Swift 5.5 ou posterior
Xcode 13+ (para desenvolvimento)
Claude Desktop

Instalação

Pré-requisitos

Obtenha uma chave de API CoinPaprika GRATUITA (opcional, mas recomendada para análise técnica):
- Visite CoinPaprika API
- Clique em "Start Free" e registre-se
- Copie sua chave de API para o passo 3
- Nota: Dados básicos de preço funcionam sem chave de API via DexPaprika!

Instalação Rápida

Clone o repositório:

git clone https://github.com/M-Pineapple/CryptoAnalysisMCP.git
cd CryptoAnalysisMCP

Compile o projeto:

./build-release.sh

Configure o Claude Desktop adicionando ao ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "crypto-analysis": {
      "command": "/path/to/CryptoAnalysisMCP/crypto-analysis-mcp",
      "env": {
        "COINPAPRIKA_API_KEY": "your-free-api-key-here"
      }
    }
  }
}

A partir da v1.3.0, o servidor roda no transporte oficial mcp-swift-sdk por padrão. Para optar pelo transporte SimpleMCP legado (válvula de segurança de uma versão, removido na v1.4), passe "args": ["--use-legacy"] na configuração acima.

Reinicie o Claude Desktop

Instalação Global (Opcional)

sudo cp ./.build/release/CryptoAnalysisMCP /usr/local/bin/crypto-analysis-mcp

Depois use isso na configuração do Claude Desktop:

{
  "mcpServers": {
    "crypto-analysis": {
      "command": "/usr/local/bin/crypto-analysis-mcp"
    }
  }
}

Uso

📝 Exemplos de Prompts

Novo em análise de cripto? Consulte nosso abrangente Guia de Prompts de Análise de Cripto com mais de 100 exemplos de prompts para:

🏃 Day Trading
📊 Swing Trading
💼 Investimento de Longo Prazo
📈 Indicadores Técnicos
🎯 Gerenciamento de Risco
E muito mais!

Comandos Disponíveis

Uma vez configurado, você pode usar estes comandos no Claude:

Obter Preço Atual

crypto-analysis:get_crypto_price
  symbol: "BTC"

Indicadores Técnicos

crypto-analysis:get_technical_indicators
  symbol: "ETH"
  timeframe: "daily"

Detecção de Padrões Gráficos

crypto-analysis:detect_chart_patterns
  symbol: "SOL"
  timeframe: "4h"

Sinais de Negociação

crypto-analysis:get_trading_signals
  symbol: "ADA"
  risk_level: "moderate"
  timeframe: "daily"

Análise Completa

crypto-analysis:get_full_analysis
  symbol: "DOT"
  timeframe: "weekly"
  risk_level: "aggressive"

Suporte e Resistência

crypto-analysis:get_support_resistance
  symbol: "MATIC"
  timeframe: "daily"

Análise Multi-timeframe

crypto-analysis:multi_timeframe_analysis
  symbol: "AVAX"

Comandos de Liquidez e DEX

Obter Liquidez do Token

crypto-analysis:get_token_liquidity
  symbol: "PEPE"
  network: "ethereum" (optional)

Buscar Tokens por Rede

crypto-analysis:search_tokens_by_network
  network: "solana"
  query: "meme" (optional)
  limit: 20

Comparar Preços em DEXes

crypto-analysis:compare_dex_prices
  symbol: "SHIB"
  network: "ethereum"

Obter Pools da Rede

crypto-analysis:get_network_pools
  network: "ethereum"
  sort_by: "volume_usd"
  limit: 10

Obter Redes Disponíveis

crypto-analysis:get_available_networks

💡 Exemplos Rápidos

Aqui estão alguns prompts em linguagem natural que você pode usar:

1. Análise Rápida

"Give me a quick technical analysis of [SYMBOL]"
"Is [SYMBOL] bullish or bearish right now?"
"What's the trend for [SYMBOL]?"

2. Foco em Day Trading

"Analyze [SYMBOL] for day trading opportunities"
"Show me scalping levels for [SYMBOL] today"
"What are the intraday support and resistance for [SYMBOL]?"

3. Análise de Swing Trading

"Provide swing trading setup for [SYMBOL] with 3-7 day outlook"
"Analyze [SYMBOL] patterns on daily timeframe for swing trades"
"Give me entry, stop loss, and targets for swing trading [SYMBOL]"

4. Análise Institucional Completa

"Do a complete Wall Street analyst report on [SYMBOL]"
"Analyze [SYMBOL] like a hedge fund would"
"Give me all technical indicators, patterns, and signals for [SYMBOL]"

5. Estratégias Baseadas em Risco

"Show me conservative trading strategy for [SYMBOL]"
"What's the aggressive play on [SYMBOL]?"
"Give me risk-adjusted entries for [SYMBOL]"

6. Solicitações de Indicadores Específicos

"What's the RSI and MACD saying about [SYMBOL]?"
"Check Bollinger Bands squeeze on [SYMBOL]"
"Are there any chart patterns forming on [SYMBOL]?"

7. Análise de Meme Coins e Tokens DEX

"What's the price of WOJAK?"
"Analyze that new PEPE fork on Ethereum"
"Show me price data for [obscure token]"
"Track this Uniswap token: [contract address]"

8. Análise de Liquidez e DEX

"What's the liquidity for SHIB across all DEXes?"
"Show me the top pools on Solana"
"Compare PEPE prices on different DEXes"
"Find high liquidity meme coins on BSC"
"Which DEX has the best price for ETH?"
"Show me all tokens on Arbitrum with >$1M liquidity"

💡 Substitua [SYMBOL] por qualquer ticker de criptomoeda (BTC, ETH, SOL, etc.)

👉 Veja mais de 100 exemplos em nosso Guia de Prompts de Análise de Cripto

Criptomoedas Suportadas

O MCP suporta mais de 7 MILHÕES de tokens através do nosso sistema de dupla provedoria:

CoinPaprika (Principal): mais de 2.500 criptomoedas principais com análise técnica completa
DexPaprika (Alternativa): mais de 7 milhões de tokens DEX em mais de 23 blockchains — NENHUMA CHAVE DE API NECESSÁRIA!

O MCP automaticamente:

Verifica CoinPaprika primeiro para tokens estabelecidos (dados melhores, mais recursos)
Recorre ao DexPaprika para qualquer token não encontrado
Armazena resultados em cache para desempenho ideal
Funciona apenas com o símbolo do ticker

Redes Suportadas via DexPaprika:

Ethereum, BSC, Polygon, Arbitrum, Optimism, Base
Solana, Avalanche, Fantom, Aptos, Sui
E mais de 12 outras redes!

Basta usar qualquer símbolo de ticker — se existir em qualquer DEX, nós o encontraremos!

Configuração

Chave de API (Opcional, mas Recomendada)

⚠️ Importante:

Dados básicos de preço funcionam SEM chave de API via DexPaprika
Recursos de análise técnica ainda exigem uma chave de API GRATUITA da CoinPaprika

Obtenha sua chave de API GRATUITA:

Visite API CoinPaprika
Clique em "Start Free"
Crie uma conta
Copie sua chave de API

Adicione ao Claude Desktop:

Opção 1 — Variável de Ambiente (Recomendada):

{
  "mcpServers": {
    "crypto-analysis": {
      "command": "/path/to/crypto-analysis-mcp",
      "env": {
        "COINPAPRIKA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Opção 2 — Ambiente do Sistema:

export COINPAPRIKA_API_KEY="your-api-key-here"

Transporte

O CryptoAnalysisMCP v1.3+ roda no mcp-swift-sdk oficial (v0.12.1) por padrão. Um transporte SimpleMCP legado na árvore é mantido por uma versão como opção de exclusão:

Padrão (recomendado): nenhuma flag necessária.
Exclusão: adicione "args": ["--use-legacy"] à sua configuração do Claude Desktop.
--use-sdk: aceito como no-op para compatibilidade retroativa com v1.2.x; emite um aviso de depreciação único para stderr. Será removido na v1.4.

Ambos os transportes expõem as mesmas 16 ferramentas com os mesmos esquemas de entrada (verificados por um teste de integração em cada build). Diferenças no formato do wire:

O SDK serializa JSON com chaves ordenadas.
O SDK emite "description": null para ferramentas sem descrição; o caminho legado omite a chave.

Nenhuma das diferenças é semanticamente significativa, mas qualquer pessoa que compare o tráfego JSON-RPC entre versões deve estar ciente.

Compatibilidade com Estilos de Negociação

Resumo: Se você é um day trader, você DEVE obter a assinatura Pro. Não há alternativa.

Níveis Gratuito vs. Pago

Períodos de Tempo

Nível Gratuito (Sem Chave de API):

daily — Velas diárias apenas ✅

Nível Pro (US$ 99/mês) — Todos os períodos:

5m — Velas de 5 minutos
15m — Velas de 15 minutos
30m — Velas de 30 minutos
1h — Velas de 1 hora
4h — Velas de 4 horas
daily — Velas diárias
weekly — Velas semanais

💡 Nota: Tentar usar qualquer período diferente de 'daily' sem uma chave Pro resultará em erro.

Níveis de Risco

conservative — Risco menor, foco em sinais fortes
moderate — Abordagem equilibrada (padrão)
aggressive — Risco maior, sinais mais sensíveis

Desenvolvimento

Compilando a partir do Código-Fonte

# Clone the repository
git clone https://github.com/M-Pineapple/CryptoAnalysisMCP.git
cd CryptoAnalysisMCP

# Build debug version
swift build

# Build release version
swift build -c release

# Run tests
swift test

Estrutura do Projeto

CryptoAnalysisMCP/
├── Sources/
│   └── CryptoAnalysisMCP/
│       ├── Main.swift                    # Entry point
│       ├── SimpleMCP.swift               # MCP protocol implementation
│       ├── CryptoDataProvider.swift      # CoinPaprika API integration
│       ├── DexPaprikaDataProvider.swift  # 🆕 DexPaprika integration
│       ├── TechnicalAnalyzer.swift       # Indicators & calculations
│       ├── ChartPatternRecognizer.swift  # Pattern detection
│       ├── SupportResistanceAnalyzer.swift # Support/resistance levels
│       ├── AnalysisFormatters.swift      # Output formatting
│       └── Models.swift                  # Data models
├── Tests/                                # Unit tests
├── Package.swift                         # Swift package manifest
└── README.md                             # This file

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Faça um fork do repositório
Crie sua branch de recurso (git checkout -b feature/AmazingFeature)
Faça commit das suas alterações (git commit -m 'Add some AmazingFeature')
Envie para a branch (git push origin feature/AmazingFeature)
Abra um Pull Request

Licença

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

Agradecimentos

Construído com Swift e o Model Context Protocol
Alimentado pela API CoinPaprika para dados de criptomoedas
🆕 Aprimorado com DexPaprika para mais de 7 milhões de tokens DEX
Algoritmos de análise técnica baseados em padrões da indústria
Agradecimento especial à equipe CoinPaprika pelo apoio!

Solução de Problemas

MCP não aparecendo no Claude

Garanta que o caminho em claude_desktop_config.json seja absoluto
Verifique se o binário tem permissões de execução: chmod +x crypto-analysis-mcp
Reinicie o Claude Desktop após alterações de configuração

Limites de Taxa da API

O nível gratuito da CoinPaprika tem limites de taxa. Se você encontrar erros 402, considere:

Usar o período diário (mais compatível com o nível gratuito)
Adicionar uma chave de API para limites maiores
Implementar limitação de requisições

Problemas de Build

Se você encontrar erros de build:

Garanta que o Swift 5.5+ esteja instalado: swift --version
Limpe o build: swift package clean
Atualize as dependências: swift package update

💖 Apoie Este Projeto

Se o CryptoAnalysisMCP ajudou a aprimorar seu fluxo de trabalho de análise de criptomoedas ou economizou seu tempo com indicadores técnicos, considere apoiar seu desenvolvimento:

Seu apoio me ajuda a:

Manter e melhorar o CryptoAnalysisMCP com novos recursos
Manter o projeto open-source e gratuito para todos
Dedicar mais tempo para atender solicitações de usuários e correções de bugs
Explorar novos indicadores e técnicas de análise

Obrigado por considerar apoiar meu trabalho! 🙏

Suporte

Para problemas, dúvidas ou sugestões, abra uma issue no GitHub.

Conecte-se

Siga-me para atualizações e insights de análise de criptomoedas:

🐦 Twitter/X: @m_pineapple__
🐙 GitHub: @M-Pineapple

Feito com ❤️ por 🍍