Cryptocurrency Market Data

Cryptocurrency Market Data MCP Server

Um servidor Model Context Protocol (MCP) que fornece dados de mercado de criptomoedas em tempo real e históricos por meio da integração com as principais exchanges. Este servidor permite que LLMs como o Claude busquem preços atuais, analisem tendências de mercado e acessem informações detalhadas de negociação.

Recursos

• Dados de Mercado em Tempo Real

  • Preços atuais de criptomoedas
  • Resumos de mercado com spreads de compra/venda
  • Principais pares de negociação por volume
  • Suporte a múltiplas exchanges

• Análise Histórica

  • Dados OHLCV (candlestick)
  • Estatísticas de variação de preço
  • Acompanhamento do histórico de volume
  • Períodos personalizáveis

• Suporte a Exchanges

  • Binance
  • Coinbase
  • Kraken
  • KuCoin
  • HyperLiquid
  • Huobi
  • Bitfinex
  • Bybit
  • OKX
  • MEXC

Instalação

Instalação via Smithery

Para instalar o Cryptocurrency Market Data Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install mcp-server-ccxt --client claude

Instalação Manual

# Using uv (recommended)
uv pip install mcp ccxt

# Using pip
pip install mcp ccxt

Uso

Executando o Servidor

python crypto_server.py

Conectando com o Claude Desktop

1. Abra a configuração do Claude Desktop em:

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

2. Adicione a configuração do servidor:

{
    "mcpServers": {
        "crypto": {
            "command": "python",
            "args": ["/path/to/crypto_server.py"]
        }
    }
}

3. Reinicie o Claude Desktop

Ferramentas Disponíveis

1. get-price

   • Obtenha o preço atual de qualquer par de negociação
   • Exemplo: "Qual é o preço atual de BTC/USDT na Binance?"

2. get-market-summary

   • Obtenha informações detalhadas do mercado
   • Exemplo: "Mostre-me um resumo de mercado para ETH/USDT"

3. get-top-volumes

   • Liste os principais pares de negociação por volume
   • Exemplo: "Quais são os 5 principais pares de negociação na Kraken?"

4. list-exchanges

   • Mostre todas as exchanges suportadas
   • Exemplo: "Quais exchanges são suportadas?"

5. get-historical-ohlcv

   • Obtenha dados históricos de candlestick
   • Exemplo: "Mostre-me os últimos 7 dias de dados de preço de BTC/USDT em intervalos de 1 hora"

6. get-price-change

   • Calcule variações de preço em diferentes períodos
   • Exemplo: "Qual é a variação de preço em 24 horas para SOL/USDT?"

7. get-volume-history

   • Acompanhe o volume de negociação ao longo do tempo
   • Exemplo: "Mostre-me o histórico de volume de negociação para ETH/USDT na última semana"

Exemplos de Consultas

Aqui estão algumas perguntas de exemplo que você pode fazer ao Claude depois que o servidor estiver conectado:

- What's the current Bitcoin price on Binance?
- Show me the top 5 trading pairs by volume on Coinbase
- How has ETH/USDT performed over the last 24 hours?
- Give me a detailed market summary for SOL/USDT on Kraken
- What's the trading volume history for BNB/USDT over the last week?

Detalhes Técnicos

Dependências

• mcp: Model Context Protocol SDK
• ccxt: Cryptocurrency Exchange Trading Library
• Python 3.9 ou superior

Arquitetura

O servidor utiliza:

• Suporte assíncrono do CCXT para comunicação eficiente com exchanges
• Sistema de ferramentas do MCP para integração com LLMs
• Formatação padronizada de dados para saídas consistentes
• Pool de conexões para desempenho ideal

Tratamento de Erros

O servidor implementa tratamento robusto de erros para:

• Pares de negociação inválidos
• Problemas de conectividade com exchanges
• Limitação de taxa
• Requisições malformadas
• Timeouts de rede

Desenvolvimento

Executando Testes

# To be implemented
pytest tests/

Contribuindo

1. Faça um fork do repositório
2. Crie um branch de funcionalidade
3. Faça suas alterações
4. Envie um pull request

Desenvolvimento Local

# Clone the repository
git clone [repository-url]
cd crypto-mcp-server

# Install dependencies
uv pip install -e .

Solução de Problemas

Problemas Comuns

1. Erros de Conexão com Exchanges

   • Verifique sua conexão com a internet
   • Verifique se a exchange está operacional
   • Certifique-se de que o par de negociação existe na exchange selecionada

2. Limitação de Taxa

   • Implemente atrasos entre requisições
   • Use diferentes exchanges para consultas de alta frequência
   • Verifique os limites de taxa específicos de cada exchange

3. Problemas de Formatação de Dados

   • Verifique o formato do par de negociação (ex.: BTC/USDT, não BTCUSDT)
   • Verifique as especificações de período
   • Certifique-se de que os parâmetros numéricos estejam dentro de faixas válidas

Licença

Licença MIT - Consulte o arquivo LICENSE para obter detalhes

Agradecimentos

• CCXT pelas integrações com exchanges
• Model Context Protocol pela especificação do MCP
• As exchanges de criptomoedas por fornecerem APIs de dados de mercado