Cryptocurrency Market Data MCP Server

MIT License
26
  • Apple

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides real-time cryptocurrency market data from Binance, including current prices, market summaries, and trading pairs

  • Fetches cryptocurrency market data from Coinbase, allowing access to prices, trading volumes, and market information

  • Offers integration with KuCoin exchange for cryptocurrency price data, market summaries, and trading information

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

Instalación mediante herrería

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

python crypto_server.py

Conectando con Claude Desktop

  1. Abra la configuración de Claude Desktop en:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
  2. Agregue la configuración del servidor:
{ "mcpServers": { "crypto": { "command": "python", "args": ["/path/to/crypto_server.py"] } } }
  1. Reiniciar Claude Desktop

Herramientas disponibles

  1. obtener precio
    • Obtenga el precio actual de cualquier par comercial
    • Ejemplo: "¿Cuál es el precio actual de BTC/USDT en Binance?"
  2. obtener resumen del mercado
    • Obtenga información detallada del mercado
    • Ejemplo: "Muéstrame un resumen del mercado de ETH/USDT"
  3. 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?"
  4. intercambios de listas
    • Mostrar todos los intercambios admitidos
    • Ejemplo: "¿Qué intercambios son compatibles?"
  5. 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"
  6. 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?"
  7. 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 modelo
  • ccxt : 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

  1. Bifurcar el repositorio
  2. Crear una rama de características
  3. Realiza tus cambios
  4. 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

  1. 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
  2. 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
  3. 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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

  1. Features
    1. Installation
      1. Installing via Smithery
      2. Installing Manually
    2. Usage
      1. Running the Server
      2. Connecting with Claude Desktop
      3. Available Tools
      4. Example Queries
    3. Technical Details
      1. Dependencies
      2. Architecture
      3. Error Handling
    4. Development
      1. Running Tests
      2. Contributing
      3. Local Development
    5. Troubleshooting
      1. Common Issues
    6. License
      1. Acknowledgments
        ID: 9kbbk1kmg2