Crypto Price & Market Analysis (JJ Fork)

Servidor MCP de Preço e Análise de Criptomoedas (JJ Fork)

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.

📌 Sobre Este Fork

Este é um fork do projeto original mcp-crypto-price de Tracey Russell

✅ O que mudou:

• Atualizado para usar a API CoinCap v3 (já que a v2 está sendo descontinuada).
• Melhorias adicionais e testes planejados conforme o tempo permitir.

💡 Agradecimento especial à Coin Cap pelo modelo de assinatura "stake-to-API" — algo que espero que mais provedores de API adotem. O cansaço de assinaturas é real!

Nota do Pacote: Este projeto está hospedado no GitHub como wazzan/mcp-coincap-jj, mas publicado no npm como @bujaayjaay/mcp-coincap-jj

---

🚀 Início Rápido (Para Usuários de Primeira Viagem)

Se você é novo em servidores MCP, este guia fornece instruções passo a passo para começar.

Testei isso em uma VM Windows 11 para evitar bagunçar meu Mac — funcionou perfeitamente!

Locais de Configuração do Claude Desktop:

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

---

🟢 Guia de Configuração no Windows (Mesmos Passos para Qualquer Cliente MCP)

1. Instale o Node.js: (https://nodejs.org/en)
2. Instale o Claude Desktop
3. Configure o Claude Desktop:
   • Abra o menu hambúrguer (canto superior esquerdo) → Arquivo → Configurações → Desenvolvedor → Editar Config
   • Isso abre o local do arquivo claude_desktop_config.json no Windows Explorer.
   • Edite com seu editor favorito e adicione a seguinte configuração (certifique-se de incluir todas as chaves de fechamento!).

Nota: você pode usar estas mesmas instruções para qualquer outro Cliente MCP

{
  "mcpServers": {
    "mcp-coincap-jj": {
      "command": "npx",
      "args": [
        "-y",
        "@bujaayjaay/mcp-coincap-jj"
      ],
      "env": {
        "COINCAP_API_KEY": "INPUT_YOUR_API_KEY_HERE"
      }
    }
  }
}

🛠️ Configuração para Desenvolvedores (Instalação Local)

Para desenvolvedores e colaboradores que desejam trabalhar no projeto localmente:

🖥️ Opção 1: Instalar a partir do npm

npm install @bujaayjaay/mcp-coincap-jj

🖥️ Opção 2: Clonar e Executar Localmente

git clone https://github.com/wazzan/mcp-coincap-jj.git
cd mcp-coincap-jj
npm install        # Install dependencies
npm run build      # Compile TypeScript code
npm test           # Run tests to verify everything works
npm start          # Starts the MCP server locally

Config do Servidor MCP para Testes Locais (Exemplo no Windows)

• Se estiver executando localmente com npx, use esta configuração no Claude Desktop (ou em qualquer cliente MCP):

{
  "mcpServers": {
    "mcp-coincap-jj": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "C:\\Program Files\\nodejs\\npx.cmd",
        "C:\\Users\\YOUR-WINDOWS-USERNAME\\repos\\github\\mcp-coincap-jj"
      ],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

🔧 Dica Profissional: Usar caminhos absolutos no Windows garante uma experiência tranquila, especialmente ao executar vários ambientes.

Instalação via Smithery (Opcional, mas Fácil)

Embora tire um pouco da experiência de aprendizado pessoal, é um ótimo início rápido!

1. Certifique-se de ter o Smithery instalado para o seu aplicativo Claude Desktop
2. Execute o seguinte comando:

   smithery install @bujaayjaay/mcp-coincap-jj
   

3. Você será solicitado a inserir sua chave de API CoinCap durante a configuração

ATUALIZAÇÃO: Chave de API CoinCap

Agora você precisa obter uma chave de API da CoinCap para usar a API v3 atualizada, pois a v2 está sendo descontinuada: (https://pro.coincap.io/api-docs/)

⚡Uso - Ferramentas

get-crypto-price

Obtém o 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

get-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)

get-historical-analysis

Analisa dados históricos de preço com:

• Intervalos de tempo personalizáveis (5 minutos 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áximo/mínimo

Exemplos de Prompts

• "Qual é o preço atual do Bitcoin?"
• "Mostre-me a análise de mercado para ETH"
• "Dê-me o histórico de preços de 7 dias para DOGE"
• "Quais são as principais exchanges que negociam BTC?"
• "Mostre-me as tendências de preço para SOL com intervalos de 1 hora"

Inspiração do Projeto

• Este projeto é um fork do mcp-crypto-price de Tracey Russell,
• O projeto de Tracey foi inspirado no projeto coincap-mcp de Alex Andru.

Licença

Este projeto está licenciado sob a Licença MIT