Crypto Trader

Ferramenta MCP Crypto Trader para Claude Desktop

Uma ferramenta MCP (Model Context Protocol) que fornece dados de mercado de criptomoedas usando a API CoinGecko, projetada especificamente para o Claude Desktop.

Tutorial

Para um guia detalhado sobre configuração e uso desta ferramenta, confira nosso tutorial no Medium: Tutorial: Usando o Claude Desktop com a Ferramenta MCP Crypto Trader para Obter Dados de Criptomoedas em Tempo Real

Recursos

• Dados de preço de criptomoedas em tempo real
• Informações detalhadas de mercado para criptomoedas
• Gráficos históricos de preços
• Funcionalidade de busca de criptomoedas
• Acompanhamento de criptomoedas em tendência
• Estatísticas globais do mercado

Configuração

1. Certifique-se de ter o Python 3.10 ou superior instalado

2. Instale as dependências:

pip install -r requirements.txt

Integração com o Claude Desktop

1. Configure suas configurações de MCP no Claude Desktop adicionando o seguinte à sua configuração de MCP:

{
  "mcpServers": {
    "crypto-trader": {
      "command": "py",
      "args": ["-3.13", "C:\\Path\\To\\Your\\Crypto-Trader-MCP-ClaudeDesktop\\main.py"]
    }
  }
}

2. Substitua o caminho pelo caminho completo para o seu arquivo main.py
3. Execute o servidor usando:

py -3.13 main.py

4. Mantenha o servidor em execução enquanto usa o Claude Desktop

Ferramentas Disponíveis

1. get_crypto_price

Obtenha informações de preço de criptomoedas em tempo real:

{
    "symbol": "BTC",
    "name": "bitcoin",
    "price": 65423.12,
    "change_24h": 2.5,
    "volume_24h": 28345678901,
    "market_cap": 1234567890123,
    "timestamp": "2025-03-15T10:30:00"
}

2. get_crypto_market_data

Obtenha informações detalhadas de mercado para uma criptomoeda:

{
    "symbol": "ETH",
    "name": "Ethereum",
    "market_cap_rank": 2,
    "current_price": 3521.48,
    "market_cap": 423456789012,
    "total_volume": 15834567890,
    "high_24h": 3580.25,
    "low_24h": 3475.62,
    "price_change_24h": 45.86,
    "price_change_percentage_24h": 1.32,
    "circulating_supply": 120283456,
    "total_supply": 120283456,
    "max_supply": null,
    "ath": 4878.26,
    "ath_date": "2021-11-10T14:24:11.849Z",
    "atl": 0.432979,
    "atl_date": "2015-10-20T00:00:00.000Z"
}

3. get_crypto_historical_data

Obtenha dados históricos de preços para uma criptomoeda:

{
    "symbol": "BTC",
    "name": "bitcoin",
    "days": 30,
    "prices": [
        {
            "date": "2025-02-15T00:00:00",
            "price": 62150.23
        },
        {
            "date": "2025-02-16T00:00:00",
            "price": 63421.15
        }
        // ... more data points
    ]
}

4. search_crypto

Pesquise criptomoedas:

{
    "results": [
        {
            "id": "bitcoin",
            "symbol": "BTC",
            "name": "Bitcoin"
        },
        {
            "id": "bitcoin-cash",
            "symbol": "BCH",
            "name": "Bitcoin Cash"
        }
        // ... more results
    ]
}

5. get_trending_crypto

Obtenha criptomoedas em tendência:

{
    "trending_coins": [
        {
            "id": "pendle",
            "name": "Pendle",
            "symbol": "PENDLE",
            "market_cap_rank": 85,
            "price_btc": 0.00002356
        }
        // ... more trending coins
    ]
}

6. get_global_crypto_data

Obtenha dados globais do mercado de criptomoedas:

{
    "active_cryptocurrencies": 12875,
    "markets": 892,
    "total_market_cap_usd": 2347890123456,
    "total_volume_usd": 89723456789,
    "market_cap_percentage": {
        "BTC": 52.4,
        "ETH": 18.2
        // ... more cryptocurrencies
    },
    "updated_at": "2025-03-15T10:30:00"
}

Consultas de Exemplo

Você pode fazer perguntas ao Claude Desktop como:

• "Qual é o preço atual do Bitcoin?"
• "Mostre-me dados detalhados de mercado para Ethereum"
• "Qual é o histórico de preços do Dogecoin nos últimos 30 dias?"
• "Pesquise criptomoedas relacionadas a 'sol'"
• "Quais criptomoedas estão em tendência hoje?"
• "Qual é a capitalização total do mercado de criptomoedas agora?"

Tratamento de Erros

Todas as ferramentas incluem tratamento adequado de erros e retornarão uma mensagem de erro se algo der errado:

{
    "error": "Failed to fetch price for INVALID_SYMBOL"
}

Solução de Problemas

Se o servidor MCP não estiver funcionando no Claude Desktop:

1. Certifique-se de que o servidor esteja em execução - você deve ver uma saída ao iniciar o script
2. Verifique se o caminho nas suas configurações está correto e é absoluto
3. Certifique-se de que o Python 3.10+ esteja no PATH do seu sistema
4. Verifique se todas as dependências estão instaladas
5. Tente reiniciar o Claude Desktop
6. Verifique os logs para quaisquer mensagens de erro

Limites de Taxa

Esta ferramenta usa a API gratuita do CoinGecko, que possui limites de taxa. Esteja ciente de que solicitações muito frequentes podem ser limitadas pela API.

Licença

Licença MIT