Skip to main content
Glama
Cryptocurrency Market Data MCP Server

Cryptocurrency Market Data MCP Server

by Nayshins

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.

MCP Pitón CCXT insignia de herrería

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

Related MCP server: Crypto MCP Server

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

Available Tools

7 tools
get-historical-ohlcvB

Get historical OHLCV (candlestick) data for a trading pair

Inputs: symbol (required), timeframe, days_back, exchange.

get-market-summaryC

Get detailed market summary for a cryptocurrency pair from a specific exchange

Inputs: symbol (required), exchange.

get-priceB

Get current price of a cryptocurrency pair from a specific exchange

Inputs: symbol (required), exchange.

get-price-changeC

Get price change statistics over different time periods

Inputs: symbol (required), exchange.

get-top-volumesB

Get top cryptocurrencies by trading volume from a specific exchange

Inputs: limit, exchange.

get-volume-historyC

Get trading volume history over time

Inputs: symbol (required), days, exchange.

list-exchangesB

List all supported cryptocurrency exchanges

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no ambiguity: get-historical-ohlcv for candlestick data, get-market-summary for detailed pair info, get-price for current price, get-price-change for statistics, get-top-volumes for volume rankings, get-volume-history for volume trends, and list-exchanges for exchange listing. The descriptions precisely differentiate their functions, making misselection unlikely.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using kebab-case (e.g., get-historical-ohlcv, list-exchanges). The naming is predictable and readable throughout, with 'get-' or 'list-' prefixes clearly indicating the action, ensuring a uniform and professional appearance.

    Tool Count5/5

    With 7 tools, the server is well-scoped for cryptocurrency market data, covering key areas like pricing, volume, exchanges, and historical data. Each tool earns its place by addressing specific market analysis needs, avoiding bloat while providing comprehensive coverage for the domain.

    Completeness4/5

    The tool set offers strong coverage for cryptocurrency market data, including price, volume, historical data, and exchange info. Minor gaps exist, such as no tools for order book depth, trade history, or market sentiment, but agents can work around these with the provided tools for core market analysis tasks.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that exposes Binance cryptocurrency exchange data to LLMs, allowing agents to access real-time prices, order books, and historical market data without requiring API keys.
      21
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time and historical cryptocurrency market data using ccxt, enabling users to fetch live prices, historical candlestick data, and stream real-time ticker updates across multiple exchanges.
      14
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides cryptocurrency data tools and resources via an HTTP endpoint. It enables users to fetch real-time market data from Binance, track activity logs, and generate cryptocurrency executive summaries.
      ISC
    • A
      license
      A
      quality
      D
      maintenance
      A comprehensive cryptocurrency market-data MCP server with 49 tools across six data sources, enabling LLMs to answer market questions via natural language.
      49
      MIT