Servidor MCP de datos del mercado de criptomonedas
Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona datos históricos y en tiempo real del mercado de criptomonedas mediante la integración con las principales plataformas de intercambio. Este servidor permite a los LLM como Claude consultar precios actuales, analizar tendencias del mercado y acceder a información detallada sobre las operaciones.
Características
- Datos de mercado en tiempo real
- Precios actuales de las criptomonedas
- Resúmenes de mercado con diferenciales de oferta y demanda
- Principales pares de trading por volumen
- Soporte para múltiples intercambios
- Análisis histórico
- Datos de OHLCV (velas japonesas)
- Estadísticas de cambios de precios
- Seguimiento del historial de volumen
- Marcos de tiempo personalizables
- Soporte de Exchange
- Binance
- Coinbase
- Kraken
- KuCoin
- Hiperlíquido
- Huobi
- Bitfinex
- Bybit
- OKX
- MEXC
Instalación
Para instalar Cryptocurrency Market Data Server para Claude Desktop automáticamente a través de 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
Ejecución del servidor
Conectando con Claude Desktop
- Abra la configuración de Claude Desktop en:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Ventanas:
%APPDATA%\Claude\claude_desktop_config.json
- Agregue la configuración del servidor:
{
"mcpServers": {
"crypto": {
"command": "python",
"args": ["/path/to/crypto_server.py"]
}
}
}
- Reiniciar Claude Desktop
Herramientas disponibles
- obtener precio
- Obtenga el precio actual de cualquier par comercial
- Ejemplo: "¿Cuál es el precio actual de BTC/USDT en Binance?"
- obtener resumen del mercado
- Obtenga información detallada del mercado
- Ejemplo: "Muéstrame un resumen del mercado de ETH/USDT"
- obtener los máximos volúmenes
- Lista de los principales pares comerciales por volumen
- Ejemplo: "¿Cuáles son los 5 pares comerciales principales en Kraken?"
- intercambios de listas
- Mostrar todos los intercambios admitidos
- Ejemplo: "¿Qué intercambios son compatibles?"
- obtener-histórico-ohlcv
- Obtener datos históricos de velas
- Ejemplo: "Muéstrame los datos del precio de BTC/USDT de los últimos 7 días en intervalos de 1 hora"
- obtener cambio de precio
- Calcular cambios de precios en diferentes períodos de tiempo
- Ejemplo: "¿Cuál es el cambio de precio de SOL/USDT en 24 horas?"
- obtener historial de volumen
- Seguimiento del volumen de operaciones a lo largo del tiempo
- Ejemplo: "Muéstrame el historial del volumen de operaciones de ETH/USDT durante la última semana"
Consultas de ejemplo
Aquí hay algunos ejemplos de preguntas que puedes 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 protocolo de contexto de modeloccxt : Biblioteca de intercambio de criptomonedas- Python 3.9 o superior
Arquitectura
El servidor utiliza:
- Soporte asíncrono de CCXT para una comunicación de intercambio eficiente
- Sistema de herramientas de MCP para la integración de LLM
- Formato de datos estandarizado para obtener resultados consistentes
- Agrupación de conexiones para un rendimiento óptimo
Manejo de errores
El servidor implementa un manejo robusto de errores para:
- Pares comerciales no válidos
- Problemas de conectividad de Exchange
- Limitación de velocidad
- Solicitudes malformadas
- Tiempos de espera de la red
Desarrollo
Ejecución de pruebas
# To be implemented
pytest tests/
Contribuyendo
- Bifurcar el repositorio
- Crear una rama de características
- Realiza tus cambios
- Enviar una solicitud de extracción
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
- Errores de conexión de Exchange
- Comprueba tu conexión a Internet
- Verificar que el intercambio esté operativo
- Asegúrese de que el par comercial exista en el intercambio seleccionado
- Limitación de velocidad
- Implementar retrasos entre solicitudes
- Utilice diferentes intercambios para consultas de alta frecuencia
- Consulte los límites de tipos de cambio específicos del cambio
- Problemas de formato de datos
- Verificar el formato del par comercial (por ejemplo, BTC/USDT, no BTCUSDT)
- Consultar las especificaciones del plazo
- Asegúrese de que los parámetros numéricos estén dentro de rangos válidos
Licencia
Licencia MIT: consulte el archivo LICENCIA para obtener más detalles
Expresiones de gratitud