Crypto Price & Market Analysis (JJ Fork)

Servidor MCP de Precio y Análisis de Criptomonedas (JJ Fork)

Un servidor de Protocolo de Contexto de Modelo (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.

📌 Acerca de este Fork

Este es un fork del proyecto original mcp-crypto-price de Tracey Russell

✅ Lo que ha cambiado:

• Actualizado para usar la API v3 de CoinCap (ya que la v2 está siendo retirada).
• Mejoras adicionales y pruebas planificadas según el tiempo lo permita.

💡 Reconocimiento a Coin Cap por su modelo de suscripción "stake-to-API", algo que espero que más proveedores de API adopten. ¡La fatiga de suscripciones es real!

Nota del Paquete: Este proyecto está alojado en GitHub como wazzan/mcp-coincap-jj pero publicado en npm como @bujaayjaay/mcp-coincap-jj

---

🚀 Inicio Rápido (Para Usuarios Primerizos)

Si eres nuevo en los servidores MCP, esta guía proporciona instrucciones paso a paso para comenzar.

Probé esto en una máquina virtual con Windows 11 para evitar saturar mi Mac: ¡funcionó perfectamente!

Ubicaciones de Configuración de Claude Desktop:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

---

🟢 Guía de Configuración para Windows (Mismos Pasos para Cualquier Cliente MCP)

1. Instala Node.js: (https://nodejs.org/en)
2. Instala Claude Desktop
3. Configura Claude Desktop:

• Abre el menú de hamburguesa (esquina superior izquierda) → Archivo → Configuración → Desarrollador → Editar Configuración
• Esto abre la ubicación del archivo claude_desktop_config.json en el Explorador de Windows.
• Edítalo con tu editor favorito y agrega la siguiente configuración (¡asegúrate de incluir todas las llaves de cierre!):

Nota: puedes usar estas mismas instrucciones para cualquier otro cliente MCP

{
  "mcpServers": {
    "mcp-coincap-jj": {
      "command": "npx",
      "args": [
        "-y",
        "@bujaayjaay/mcp-coincap-jj"
      ],
      "env": {
        "COINCAP_API_KEY": "INPUT_YOUR_API_KEY_HERE"
      }
    }
  }
}

🛠️ Configuración para Desarrolladores (Instalación Local)

Para desarrolladores y colaboradores que quieran trabajar en el proyecto localmente:

🖥️ Opción 1: Instalar desde npm

npm install @bujaayjaay/mcp-coincap-jj

🖥️ Opción 2: Clonar y Ejecutar Localmente

git clone https://github.com/wazzan/mcp-coincap-jj.git
cd mcp-coincap-jj
npm install        # Install dependencies
npm run build      # Compile TypeScript code
npm test           # Run tests to verify everything works
npm start          # Starts the MCP server locally

Configuración del Servidor MCP para Pruebas Locales (Ejemplo en Windows)

• Si se ejecuta localmente con npx, usa esta configuración en Claude Desktop (o cualquier cliente MCP):

{
  "mcpServers": {
    "mcp-coincap-jj": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "C:\\Program Files\\nodejs\\npx.cmd",
        "C:\\Users\\YOUR-WINDOWS-USERNAME\\repos\\github\\mcp-coincap-jj"
      ],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

🔧 Consejo Profesional: Usar rutas absolutas en Windows garantiza una experiencia fluida, especialmente al ejecutar múltiples entornos.

Instalación con Smithery (Opcional pero Fácil)

Aunque quita parte de la experiencia de aprendizaje personal, ¡es un excelente inicio rápido!

1. Asegúrate de tener Smithery instalado para tu aplicación de Claude Desktop
2. Ejecuta el siguiente comando:

   smithery install @bujaayjaay/mcp-coincap-jj
   

3. Se te pedirá ingresar tu clave de API de CoinCap durante la configuración

ACTUALIZACIÓN: Clave de API de CoinCap

Ahora debes obtener una clave de API de CoinCap para usar la API v3 actualizada, ya que la v2 está siendo retirada: (https://pro.coincap.io/api-docs/)

⚡Uso - Herramientas

get-crypto-price

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

get-market-analysis

Proporciona análisis detallado de mercado incluyendo:

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

get-historical-analysis

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 tendencias de precios
• Métricas de volatilidad
• Rangos de precios máximos/mínimos

Ejemplos de Consultas

• "¿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 intercambios que negocian BTC?"
• "Muéstrame las tendencias de precios para SOL con intervalos de 1 hora"

Inspiración del Proyecto

• Este proyecto es un fork del mcp-crypto-price de Tracey Russell,
• El proyecto de Tracey fue inspirado por el proyecto coincap-mcp de Alex Andru.

Licencia

Este proyecto está licenciado bajo la Licencia MIT