Crypto Trader

Herramienta MCP Crypto Trader para Claude Desktop

Una herramienta MCP (Model Context Protocol) que proporciona datos del mercado de criptomonedas utilizando la API de CoinGecko, diseñada específicamente para Claude Desktop.

Tutorial

Para obtener una guía detallada sobre cómo configurar y usar esta herramienta, consulta nuestro tutorial en Medium: Tutorial: Usando Claude Desktop con la Herramienta MCP Crypto Trader para Obtener Datos de Criptomonedas en Tiempo Real

Características

• Datos de precios de criptomonedas en tiempo real
• Información detallada del mercado para criptomonedas
• Gráficos históricos de precios
• Funcionalidad de búsqueda de criptomonedas
• Seguimiento de criptomonedas en tendencia
• Estadísticas globales del mercado

Configuración

1. Asegúrate de tener Python 3.10 o superior instalado

2. Instala las dependencias:

pip install -r requirements.txt

Integración con Claude Desktop

1. Configura los ajustes de MCP en Claude Desktop añadiendo lo siguiente a tu configuración de MCP:

{
  "mcpServers": {
    "crypto-trader": {
      "command": "py",
      "args": ["-3.13", "C:\\Path\\To\\Your\\Crypto-Trader-MCP-ClaudeDesktop\\main.py"]
    }
  }
}

2. Reemplaza la ruta con la ruta completa a tu archivo main.py
3. Ejecuta el servidor usando:

py -3.13 main.py

4. Mantén el servidor en ejecución mientras usas Claude Desktop

Herramientas Disponibles

1. get_crypto_price

Obtén información del precio de criptomonedas en tiempo real:

{
    "symbol": "BTC",
    "name": "bitcoin",
    "price": 65423.12,
    "change_24h": 2.5,
    "volume_24h": 28345678901,
    "market_cap": 1234567890123,
    "timestamp": "2025-03-15T10:30:00"
}

2. get_crypto_market_data

Obtén información detallada del mercado para una criptomoneda:

{
    "symbol": "ETH",
    "name": "Ethereum",
    "market_cap_rank": 2,
    "current_price": 3521.48,
    "market_cap": 423456789012,
    "total_volume": 15834567890,
    "high_24h": 3580.25,
    "low_24h": 3475.62,
    "price_change_24h": 45.86,
    "price_change_percentage_24h": 1.32,
    "circulating_supply": 120283456,
    "total_supply": 120283456,
    "max_supply": null,
    "ath": 4878.26,
    "ath_date": "2021-11-10T14:24:11.849Z",
    "atl": 0.432979,
    "atl_date": "2015-10-20T00:00:00.000Z"
}

3. get_crypto_historical_data

Obtén datos históricos de precios para una criptomoneda:

{
    "symbol": "BTC",
    "name": "bitcoin",
    "days": 30,
    "prices": [
        {
            "date": "2025-02-15T00:00:00",
            "price": 62150.23
        },
        {
            "date": "2025-02-16T00:00:00",
            "price": 63421.15
        }
        // ... more data points
    ]
}

4. search_crypto

Busca criptomonedas:

{
    "results": [
        {
            "id": "bitcoin",
            "symbol": "BTC",
            "name": "Bitcoin"
        },
        {
            "id": "bitcoin-cash",
            "symbol": "BCH",
            "name": "Bitcoin Cash"
        }
        // ... more results
    ]
}

5. get_trending_crypto

Obtén criptomonedas en tendencia:

{
    "trending_coins": [
        {
            "id": "pendle",
            "name": "Pendle",
            "symbol": "PENDLE",
            "market_cap_rank": 85,
            "price_btc": 0.00002356
        }
        // ... more trending coins
    ]
}

6. get_global_crypto_data

Obtén datos globales del mercado de criptomonedas:

{
    "active_cryptocurrencies": 12875,
    "markets": 892,
    "total_market_cap_usd": 2347890123456,
    "total_volume_usd": 89723456789,
    "market_cap_percentage": {
        "BTC": 52.4,
        "ETH": 18.2
        // ... more cryptocurrencies
    },
    "updated_at": "2025-03-15T10:30:00"
}

Consultas de Ejemplo

Puedes hacer preguntas a Claude Desktop como:

• "¿Cuál es el precio actual de Bitcoin?"
• "Muéstrame datos detallados del mercado para Ethereum"
• "¿Cuál es el historial de precios de Dogecoin de los últimos 30 días?"
• "Busca criptomonedas relacionadas con 'sol'"
• "¿Qué criptomonedas están en tendencia hoy?"
• "¿Cuál es la capitalización total del mercado de criptomonedas en este momento?"

Manejo de Errores

Todas las herramientas incluyen un manejo adecuado de errores y devolverán un mensaje de error si algo sale mal:

{
    "error": "Failed to fetch price for INVALID_SYMBOL"
}

Solución de Problemas

Si el servidor MCP no funciona en Claude Desktop:

1. Asegúrate de que el servidor esté en ejecución: deberías ver resultados al iniciar el script
2. Verifica que la ruta en tu configuración sea correcta y absoluta
3. Asegúrate de que Python 3.10+ esté en la ruta del sistema (PATH)
4. Comprueba que todas las dependencias estén instaladas
5. Intenta reiniciar Claude Desktop
6. Revisa los registros para ver si hay mensajes de error

Límites de Tasa

Esta herramienta utiliza la API gratuita de CoinGecko, que tiene límites de tasa. Ten en cuenta que las solicitudes muy frecuentes pueden ser limitadas por la API.

Licencia

Licencia MIT