Crypto Price & Market Analysis

Proporciona datos de precios de criptomonedas en tiempo real, análisis de mercado y tendencias históricas utilizando la API de CoinCap.

GitHub
39
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Crypto Price & Market Analysis

smithery badge NPM Downloads

Un servidor de Model Context Protocol (MCP) que proporciona análisis integral de criptomonedas utilizando la API de CoinCap. Este servidor ofrece datos de precios en tiempo real, análisis de mercado y tendencias históricas a través de una interfaz fácil de usar. Soporta tanto transportes STDIO como Streamable HTTP.

Requisitos

  • Node.js 22.14+
  • Clave de API de CoinCap a través de COINCAP_API_KEY

Novedades

  • CAMBIOS IMPORTANTES: La API v2 de CoinCap fue eliminada. Ahora se utiliza exclusivamente la API v3. Se requiere un COINCAP_API_KEY (nivel gratuito disponible en pro.coincap.io/dashboard)
  • Se agregó transporte Streamable HTTP (manteniendo compatibilidad con STDIO)
  • Scripts CLI de Smithery para compilar y ejecutar el servidor HTTP
  • 6 nuevas herramientas: assets-search, market-global, assets-compare, analysis-candlestick, price-convert, assets-info
  • Nomenclatura jerárquica de herramientas: Todas las herramientas organizadas en nombres con prefijo de categoría (price-*, market-*, assets-*, analysis-*)
  • Esquemas de salida: Todas las herramientas ahora declaran outputSchema con structuredContent para respuestas con seguridad de tipos
  • Mejores prácticas de MCP: Indicador isError en errores de validación, descripción del servidor y plantilla de recurso asset://{symbol}

Uso

Agrega esta configuración a tu archivo de configuración de Claude Desktop:

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-crypto-price": {
      "command": "npx",
      "args": ["-y", "mcp-crypto-price"],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Si tu cliente MCP requiere iniciar mediante cmd.exe en Windows:

{
  "mcpServers": {
    "mcp-crypto-price": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-crypto-price"],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Scripts de desarrollo

pnpm dev          # Development (HTTP server with hot reload via Smithery CLI)
pnpm build         # Compile TypeScript → dist/
pnpm format        # Format source files with Prettier
pnpm lint          # Check for lint errors (ESLint + typescript-eslint)
pnpm lint:fix      # Auto-fix lint errors
pnpm types:check   # TypeScript type-check without emitting files
pnpm test          # Run all tests with Vitest
pnpm test:coverage # Run tests with coverage report (Vitest)
pnpm inspector     # Open MCP inspector for interactive debugging

Ejecutar como servidor Streamable HTTP

Puedes ejecutar el servidor a través de HTTP para entornos que soporten MCP sobre transmisión HTTP.

  • Servidor de desarrollo (recomendado durante el desarrollo):
pnpm dev
  • Compilar y ejecutar el servidor HTTP:
# Build (outputs to dist/)
pnpm build

# Start the HTTP server
pnpm start:http
  • Compilar y ejecutar el servidor STDIO:
# Build (outputs to dist/)
pnpm build

# Start the STDIO server
pnpm start:stdio

El servidor escucha en el puerto 3000 por defecto (anular con PORT). Para clientes que se conectan a través de HTTP (por ejemplo, Smithery, Claude.ai), pasa tu clave de API como parámetro de consulta:

http://localhost:3000/mcp?COINCAP_API_KEY=YOUR_API_KEY_HERE

Para implementaciones remotas:

https://mcp-crypto-price.codemonkeyinnovations.com/mcp?COINCAP_API_KEY=YOUR_API_KEY_HERE

Requerido: Clave de API de CoinCap

Este servidor utiliza la API v3 de CoinCap, que requiere una clave de API. Hay disponible un nivel gratuito.

  1. Regístrate y obtén tu clave de API en pro.coincap.io/dashboard
  2. Agrega la clave a la configuración de tu cliente MCP:
    • STDIO: a través de la variable de entorno COINCAP_API_KEY (ver ejemplos de uso arriba)
    • HTTP: a través del parámetro de consulta COINCAP_API_KEY en la URL de conexión (por ejemplo, /mcp?COINCAP_API_KEY=your_key)

Sin una clave de API válida, todas las herramientas devolverán un error con instrucciones sobre cómo obtener una.

Nota para usuarios de Smithery CLI

Este servidor MCP funciona directamente a través de pnpm dlx (configuraciones arriba) y no requiere Smithery.

Si usas Smithery CLI, autentícate con smithery auth login o configurando SMITHERY_API_KEY en tu entorno. Las versiones recientes de Smithery CLI no admiten pasar claves de API a través de --key (o patrones más antiguos de --profile).

Inicia Claude Desktop para comenzar a usar las herramientas de análisis de criptomonedas.

Herramientas

price-get

Obtiene el precio actual y estadísticas de 24 horas para cualquier criptomoneda, incluyendo:

  • Precio actual en USD
  • Cambio de precio en 24 horas
  • Volumen de negociación
  • Capitalización de mercado
  • Clasificación de mercado

price-convert

Convierte una cantidad de criptomoneda a cualquier moneda fiduciaria:

  • Utiliza datos de precios en tiempo real y tipos de cambio basados en USD
  • Parámetros: symbol (por ejemplo, BTC), amount (predeterminado 1), currency (predeterminado usd)
  • Ejemplo: 2.5 BTC en EUR

market-analysis

Proporciona análisis detallado del mercado incluyendo:

  • Top 5 exchanges por volumen
  • Variaciones de precios entre exchanges
  • Análisis de distribución de volumen
  • VWAP (Precio Promedio Ponderado por Volumen)

market-global

Proporciona una visión general de todo el mercado de criptomonedas:

  • Capitalización de mercado total de todos los activos
  • Volumen de negociación en 24 horas
  • Número de criptomonedas activas
  • Porcentaje de dominancia de Bitcoin
  • Mayores ganadores y perdedores

market-rates

Devuelve tipos de conversión basados en USD para monedas fiduciarias y criptomonedas:

  • Todos los tipos de monedas fiduciarias (base USD)
  • Top 10 tipos de criptomonedas
  • Parámetro opcional slug (por ejemplo, euro, bitcoin) para consultar un solo tipo

market-exchanges

Lista los principales exchanges de criptomonedas clasificados por volumen en 24 horas:

  • Nombre del exchange, clasificación y volumen en 24 horas en USD
  • Número de pares de negociación y porcentaje de participación de mercado
  • Parámetro opcional exchangeId (por ejemplo, binance) para detalles de un solo exchange
  • Parámetro opcional limit (1–50, predeterminado 10)

assets-top

Lista las principales criptomonedas clasificadas por capitalización de mercado, incluyendo:

  • Precio actual en USD
  • Cambio de precio en 24 horas
  • Capitalización de mercado y clasificación
  • Cantidad de resultados configurable (1–50, predeterminado 10)

assets-search

Busca criptomonedas por nombre o símbolo con coincidencia difusa:

  • Devuelve activos coincidentes con símbolo, nombre, precio y clasificación
  • Cantidad de resultados configurable (1–50, predeterminado 10)
  • Ejemplo: buscar "bit" devuelve Bitcoin, Bitcoin Cash, BitTorrent, etc.

assets-info

Devuelve metadatos detallados para una sola criptomoneda:

  • ID, clasificación, símbolo y nombre
  • Precio, cambio en 24 horas, capitalización de mercado y volumen
  • Suministro circulante y suministro máximo
  • VWAP (24 horas)

assets-compare

Compara 2–5 criptomonedas lado a lado:

  • Precio, cambio en 24 horas, capitalización de mercado, volumen y clasificación para cada activo
  • Símbolos separados por comas (por ejemplo, BTC,ETH,SOL)
  • Destaca el mejor rendimiento por cambio en 24 horas

analysis-historical

Analiza datos históricos de precios con:

  • Intervalos de tiempo personalizables (5 minutos a 1 día)
  • Soporte para hasta 30 días de datos históricos
  • Análisis de tendencia de precios
  • Métricas de volatilidad
  • Rangos de precios máximos/mínimos

analysis-technical

Devuelve los últimos indicadores técnicos para cualquier criptomoneda:

  • SMA (Media Móvil Simple) con período
  • EMA (Media Móvil Exponencial) con período
  • RSI (Índice de Fuerza Relativa) con señal de Sobrecompra/Sobreventa/Neutral
  • MACD con línea de señal, histograma y etiqueta Alcista/Bajista
  • VWAP (Precio Promedio Ponderado por Volumen, 24 horas)

analysis-candlestick

Recupera datos de velas OHLCV para una criptomoneda:

  • Apertura, máximo, mínimo, cierre y volumen para cada vela
  • Intervalo configurable (5m, 15m, 30m, 1h, 2h, 6h, 12h, 1d)
  • Soporta 1–30 días de velas históricas

Recursos

El servidor expone los siguientes recursos MCP:

  • info://server — Metadatos de nombre y versión del servidor
  • asset://{symbol} — Información de activos de criptomonedas por símbolo (por ejemplo, asset://BTC), devuelta como JSON

Prompts

El servidor expone los siguientes prompts MCP que los clientes pueden invocar:

PromptArgsDescripción
analyze-cryptosymbolAnálisis integral: precio, mercado, tendencias históricas
compare-cryptocurrenciessymbolsComparar 2-5 criptomonedas lado a lado
market-overview—Instantánea del mercado global: métricas, principales activos, principales exchanges
crypto-conversionsymbol, amount?, currency?Convertir cantidad de criptomoneda a fiduciaria
exchange-analysissymbolAnálisis del panorama de exchanges para una criptomoneda
technical-analysissymbolAnálisis técnico completo: indicadores, velas, tendencias
crypto-screenerqueryBuscar y filtrar criptomonedas para oportunidades

Prompts de Ejemplo

  • "¿Cuál es el precio actual de Bitcoin?"
  • "Muéstrame el análisis de mercado para ETH"
  • "Dame el historial de precios de 7 días para DOGE"
  • "¿Cuáles son los principales exchanges que negocian BTC?"
  • "Muéstrame las tendencias de precios para SOL con intervalos de 1 hora"
  • "¿Cuáles son los indicadores técnicos para ETH en este momento?"
  • "¿Cuál es el tipo de cambio actual de EUR a USD?"
  • "¿Qué exchanges de criptomonedas tienen el mayor volumen en 24 horas?"
  • "Busca criptomonedas que coincidan con 'sol'"
  • "Dame una visión global del mercado de criptomonedas"
  • "Compara BTC, ETH y SOL lado a lado"
  • "Muéstrame datos de velas de 1 hora para BTC en los últimos 3 días"
  • "Convierte 2.5 BTC a EUR"
  • "Obtén información detallada sobre el activo Ethereum"
  • "Genera un análisis integral de una criptomoneda que cubra precio, mercado y tendencias históricas"
  • "Encuentra todas las criptomonedas con 'bit' en su nombre y muéstrame sus precios actuales"
  • "¿Cuál es la clasificación por capitalización de mercado y el suministro circulante de Cardano?"
  • "Compara las 3 principales stablecoins y muestra cuál tiene el mayor volumen"
  • "Muéstrame cómo se ha desempeñado Bitcoin en los últimos 30 días con velas diarias"
  • "Convierte 100 SOL a GBP y muestra el tipo de cambio"
  • "Dame una instantánea completa del mercado: métricas globales, principales ganadores y dominancia de BTC"
  • "¿Cuáles son las criptomonedas con mejor y peor rendimiento en las últimas 24 horas?"
  • "Muéstrame datos de velas de 15 minutos para ETH en los últimos 2 días"
  • "Compara tokens DeFi: UNI, AAVE, COMP y MKR"
  • "¿Cuál es el VWAP y el suministro máximo de Bitcoin?"
  • "Busca tokens de capa 2 y compara los mejores resultados"

Licencia

Este proyecto está licenciado bajo la Licencia MIT