Cryptocurrency Market Data

Servidor MCP de Datos de Mercado de Criptomonedas

Un servidor de Model Context Protocol (MCP) que proporciona datos de mercado de criptomonedas en tiempo real e históricos mediante la integración con los principales exchanges. Este servidor permite que LLMs como Claude obtengan precios actuales, analicen tendencias del mercado y accedan a información detallada de trading.

Características

• Datos de Mercado en Tiempo Real

  • Precios actuales de criptomonedas
  • Resúmenes de mercado con spreads de compra/venta
  • Principales pares de trading por volumen
  • Soporte para múltiples exchanges

• Análisis Histórico

  • Datos OHLCV (velas)
  • Estadísticas de cambio de precio
  • Seguimiento del historial de volumen
  • Marcos temporales personalizables

• Soporte de Exchanges

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

Instalación

Instalación mediante Smithery

Para instalar Cryptocurrency Market Data Server para Claude Desktop automáticamente mediante Smithery:

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

Instalación Manual

# Using uv (recommended)
uv pip install mcp ccxt

# Using pip
pip install mcp ccxt

Uso

Ejecutar el Servidor

python crypto_server.py

Conexión con Claude Desktop

1. Abra la configuración de Claude Desktop en:

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

2. Agregue la configuración del servidor:

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

3. Reinicie Claude Desktop

Herramientas Disponibles

1. get-price

   • Obtenga el precio actual de cualquier par de trading
   • Ejemplo: "¿Cuál es el precio actual de BTC/USDT en Binance?"

2. get-market-summary

   • Consulte información detallada del mercado
   • Ejemplo: "Muéstrame un resumen de mercado para ETH/USDT"

3. get-top-volumes

   • Liste los principales pares de trading por volumen
   • Ejemplo: "¿Cuáles son los 5 principales pares de trading en Kraken?"

4. list-exchanges

   • Muestre todos los exchanges compatibles
   • Ejemplo: "¿Qué exchanges son compatibles?"

5. get-historical-ohlcv

   • Obtenga datos históricos de velas
   • Ejemplo: "Muéstrame los últimos 7 días de datos de precio de BTC/USDT en intervalos de 1 hora"

6. get-price-change

   • Calcule cambios de precio en diferentes marcos temporales
   • Ejemplo: "¿Cuál es el cambio de precio de SOL/USDT en 24 horas?"

7. get-volume-history

   • Realice seguimiento del volumen de trading a lo largo del tiempo
   • Ejemplo: "Muéstrame el historial de volumen de trading de ETH/USDT durante la última semana"

Consultas de Ejemplo

Aquí hay algunas preguntas de ejemplo que puede hacerle a Claude una vez que el servidor esté 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?

Detalles Técnicos

Dependencias

• mcp: SDK de Model Context Protocol
• ccxt: Biblioteca de trading de exchanges de criptomonedas
• Python 3.9 o superior

Arquitectura

El servidor utiliza:

• Soporte asíncrono de CCXT para una comunicación eficiente con los exchanges
• El sistema de herramientas de MCP para la integración con LLMs
• Formato de datos estandarizado para salidas consistentes
• Agrupación de conexiones para un rendimiento óptimo

Manejo de Errores

El servidor implementa un manejo robusto de errores para:

• Pares de trading inválidos
• Problemas de conectividad con los exchanges
• Límites de velocidad (rate limiting)
• Solicitudes mal formadas
• Tiempos de espera de red

Desarrollo

Ejecutar Pruebas

# To be implemented
pytest tests/

Contribuir

1. Haga un fork del repositorio
2. Cree una rama de características
3. Realice sus cambios
4. Envíe una solicitud de pull request

Desarrollo Local

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

# Install dependencies
uv pip install -e .

Solución de Problemas

Problemas Comunes

1. Errores de Conexión con Exchanges

   • Verifique su conexión a internet
   • Confirme que el exchange esté operativo
   • Asegúrese de que el par de trading exista en el exchange seleccionado

2. Límites de Velocidad

   • Implemente retrasos entre solicitudes
   • Utilice diferentes exchanges para consultas de alta frecuencia
   • Verifique los límites de velocidad específicos de cada exchange

3. Problemas de Formato de Datos

   • Verifique el formato del par de trading (por ejemplo, BTC/USDT, no BTCUSDT)
   • Revise las especificaciones del marco temporal
   • Asegúrese de que los parámetros numéricos estén dentro de rangos válidos

Licencia

Licencia MIT - Consulte el archivo LICENSE para más detalles

Agradecimientos

• CCXT por las integraciones con exchanges
• Model Context Protocol por la especificación de MCP
• Los exchanges de criptomonedas por proporcionar las APIs de datos de mercado