CryptoAnalysisMCP

Proporciona análisis técnico integral de criptomonedas, incluyendo datos de precios en tiempo real, indicadores técnicos, detección de patrones de gráficos y señales de trading para más de 2,500 criptomonedas.

GitHub

Prueba este MCPPatrocinado

Documentación

CryptoAnalysisMCP v1.3 🚀

¡Soporta más de 7 MILLONES de tokens mediante la integración con DexPaprika! 🎉

Un servidor MCP (Model Context Protocol) para análisis técnico integral de criptomonedas. Construido con Swift, proporciona datos de precios en tiempo real, indicadores técnicos, detección de patrones de gráficos y señales de trading para más de 7 millones de criptomonedas, desde Bitcoin hasta la moneda meme más nueva en cualquier DEX.

⚠️ IMPORTANTE PARA DAY TRADERS: Esta herramienta requiere una suscripción Pro de $99/mes para análisis intradía. El nivel gratuito solo admite velas diarias, lo que la hace adecuada únicamente para traders de swing e inversores a largo plazo.

⚠️ Aviso legal

CryptoAnalysisMCP se proporciona solo con fines informativos y educativos. No es asesoramiento financiero, de inversión, de trading o fiscal, y nada de lo que produzca debe tratarse como una recomendación para comprar, vender o mantener cualquier activo.

Los indicadores técnicos, patrones de gráficos y señales de trading se calculan a partir de datos públicos de mercado utilizando fórmulas conocidas. Son imperfectos, pueden estar equivocados y no ofrecen ninguna garantía predictiva.
Los mercados de criptomonedas son altamente volátiles. Puede perder toda su inversión, e incluso más de lo que invirtió si utiliza apalancamiento o margen. Nunca opere con dinero que no pueda permitirse perder.
El rendimiento pasado, incluidos los ejemplos, backtests o resultados de muestra en este repositorio, no predice rendimientos futuros.
El autor y los colaboradores no son asesores financieros autorizados. Este proyecto no está afiliado, respaldado ni operado por ningún exchange, bróker, regulador o proveedor de datos.
Siempre haga su propia investigación (DYOR), consulte a un profesional financiero calificado sobre su situación específica y verifique cualquier dato que produzca esta herramienta contra una fuente autorizada antes de actuar sobre él.
El software se proporciona "tal cual", sin garantía de ningún tipo, según la Licencia MIT. El autor y los colaboradores no son responsables de pérdidas, daños o consecuencias derivadas del uso de esta herramienta.

Al usar CryptoAnalysisMCP usted reconoce y acepta estos términos. Consulte DISCLAIMER.md para el texto completo.

🆕 Novedades en v1.3

🔄 Transporte SDK predeterminado

Se migró del SimpleMCP interno al mcp-swift-sdk oficial v0.12.1 como transporte predeterminado
El SimpleMCP heredado está disponible mediante la bandera --use-legacy (válvula de seguridad de una versión; se eliminará en v1.4)
Ambos transportes exponen las mismas 16 herramientas con esquemas idénticos

⚙️ Toolchain Swift 6.1

Cumplimiento estricto de concurrencia con cero advertencias
Patrones modernos de async/await en todo el código
Mayor seguridad de tipos y gestión de memoria

📦 Paquete de calidad v1.2

Protocolo DataProvider para fuentes de datos conectables (CoinPaprika principal, DexPaprika de respaldo)
Precisión matemática corregida en todos los indicadores técnicos (RSI, MACD, OBV, Williams %R, Bandas de Bollinger)
Más de 2,989 pruebas de integración y de vectores dorados garantizan la precisión de los indicadores

🐦 ¡Siga a @m_pineapple__ para actualizaciones!

Características

💡 ¿No sabe qué preguntar? ¡Consulte nuestra Guía de Prompts de Análisis de Cripto para inspirarse!

Soporte universal de tokens: Más de 7 MILLONES de tokens mediante la integración con DexPaprika
Analítica de pools de liquidez: Monitoree liquidez, volumen y datos de pools en DEXes
Resolución dinámica de símbolos: Soporta automáticamente todas las criptomonedas
Datos de precios en tiempo real: Precios actuales, volumen, capitalización de mercado y cambios porcentuales
Indicadores técnicos: RSI, MACD, Medias Móviles, Bandas de Bollinger y más
Detección de patrones de gráficos: Cabeza y hombros, triángulos, dobles techos/suelos
Niveles de soporte y resistencia: Identificación automática de niveles de precios clave
Señales de trading: Recomendaciones de compra/venta/mantener basadas en análisis técnico
Análisis multi-timeframe: Marcos temporales de 4 horas, diario, semanal y mensual
Filtrado de señales ajustado al riesgo: Umbrales conservadores, moderados y agresivos para la confianza de las señales

🗺️ Hoja de ruta

v1.4 (Planificada)

Eliminar el transporte SimpleMCP heredado (el SDK se vuelve obligatorio)

¿Quiere sugerir una función? ¡Abra un issue en GitHub!

❓ Preguntas frecuentes

¿Necesito una clave API de pago para usar este MCP?

Respuesta corta: Depende de su estilo de trading.

⚠️ IMPORTANTE: Los day traders y scalpers NECESITAN una suscripción Pro ($99/mes). El nivel gratuito solo proporciona velas diarias, lo cual es inútil para trading intradía.

Lo que funciona SIN ninguna clave API:

✅ Datos de precios en tiempo real (con ligeros retrasos)
✅ Análisis de trading de swing (operaciones de 3-7 días)
✅ Trading de posición (semanas a meses)
✅ Análisis de inversión a largo plazo
✅ Todos los indicadores técnicos en marco temporal DIARIO
✅ 1 año de datos históricos diarios
Datos básicos de precios para más de 7 MILLONES de tokens vía DexPaprika
Datos de pools de liquidez en todos los DEXes principales
Comparación y agregación de precios en DEX

Lo que REQUIERE una clave API Pro ($99/mes):

❌ Day trading (necesita datos por hora/4h)
❌ Scalping (necesita datos por minuto)
❌ Patrones y señales intradía
❌ Actualizaciones en tiempo real/baja latencia
❌ Datos históricos más allá de 1 año
❌ Cualquier marco temporal más corto que diario

Cómo obtener su clave API GRATUITA:

Vaya a CoinPaprika API
Haga clic en "Start Free"
Regístrese para crear una cuenta
Obtenga su clave API
Agréguela a la configuración de Claude Desktop:

{
  "mcpServers": {
    "crypto-analysis": {
      "command": "/path/to/crypto-analysis-mcp",
      "env": {
        "COINPAPRIKA_API_KEY": "your-free-api-key-here"
      }
    }
  }
}

El nivel gratuito incluye:

✅ 25,000 llamadas API por mes
✅ 1 año de datos históricos diarios
✅ Más de 2,500 criptomonedas

Para funciones avanzadas, actualice a CoinPaprika Pro:

❌ Marcos temporales de 4 horas y por hora (se requiere Pro)
❌ Datos históricos extendidos más allá de 1 año
❌ Límites de tasa más altos
❌ Soporte prioritario

¿Puedo usar la API de CoinMarketCap o CoinGecko en su lugar?

Actualmente: No implementado. CryptoAnalysisMCP usa CoinPaprika como proveedor de datos principal.

Cómo agregar soporte: A partir de v1.2.0, el protocolo DataProvider facilita agregar fuentes de datos alternativas. Si le interesa la integración con CoinMarketCap o CoinGecko, ¡las contribuciones son bienvenidas! Abra un issue para discutirlo o envíe un PR.

Por qué CoinPaprika primero:

3 veces más cobertura de mercado que los competidores (más de 71,000 activos)
Nivel gratuito más generoso (25,000 llamadas API/mes)
Mejor acceso a datos históricos
Fiabilidad superior de la API (99.9% de tiempo de actividad)

¿Qué criptomonedas están soportadas?

El MCP soporta más de 7 MILLONES de tokens mediante la integración con DexPaprika:

✅ Todos los más de 2,500 tokens de CoinPaprika (monedas principales con análisis completo)
✅ Más de 7 MILLONES de tokens DEX vía DexPaprika (respaldo automático)
✅ Cada token en cada DEX en más de 23 blockchains
✅ Tokens completamente nuevos: analice tokens minutos después de su lanzamiento
✅ Monedas meme oscuras: si se negocia en un DEX, la tenemos
✅ NO SE NECESITA CLAVE API para datos básicos de precios

Ejemplos:

Monedas principales: BTC, ETH, SOL (análisis técnico completo vía CoinPaprika)
Memes populares: DOGE, SHIB, PEPE, WOJAK (datos de precios de cualquier fuente)
Nuevos lanzamientos: Ese token que se lanzó hace 5 minutos en Uniswap
Cualquier token ERC-20, BEP-20, SPL, o token en cualquier cadena soportada

¡Solo use el símbolo del ticker: el MCP lo encuentra automáticamente!

¿Por qué recibo errores de 402 Payment Required?

Está intentando usar funciones que requieren una suscripción Pro:

Causas comunes:

Usar cualquier marco temporal que no sea 'daily' (4h, 1h, 15m, etc.)
Solicitar datos de más de 1 año de antigüedad
Exceder los límites de tasa (raro)

Soluciones:

Para trading de swing/inversión: ¡Solo use el marco temporal 'daily' - es gratuito!
Para day trading: DEBE actualizar a CoinPaprika Pro ($99/mes)

NO hay opción gratuita para day trading. Si necesita datos intradía, debe pagar.

¿Qué tan precisas son las señales de trading?

Las señales de trading son solo para fines informativos; consulte el Aviso legal al inicio de este README y el DISCLAIMER.md completo. Se basan en indicadores técnicos bien establecidos, pero ninguna predicción es 100% precisa. Siempre haga su propia investigación y nunca invierta más de lo que pueda permitirse perder.

¿Puedo usar esto para trading automatizado?

Aunque técnicamente es posible, recomendamos encarecidamente precaución:

Este MCP proporciona análisis, no ejecución
Requiere mecanismos de seguridad adicionales
Necesita una gestión de riesgos adecuada
Debe probarse exhaustivamente con backtesting
Considere primero el trading en papel

¿Con qué frecuencia se actualizan los datos?

Depende de su nivel de API:

Nivel gratuito: Retrasos de ~1-5 minutos
Nivel Pro: Actualizaciones de precios cada 30 segundos
Caché local: 1-5 minutos para reducir llamadas API

¿Mi clave API es segura?

¡Sí! Su clave API:

Nunca está codificada
Solo se lee de variables de entorno
Nunca se registra ni transmite
Solo se usa para llamadas API de CoinPaprika
Sigue las mejores prácticas de seguridad

¿Puedo contribuir a este proyecto?

¡Absolutamente! Damos la bienvenida a contribuciones:

Correcciones de errores
Nuevos indicadores
Mejoras de rendimiento
Actualizaciones de documentación
Sugerencias de funciones

Consulte nuestra sección Contributing para las pautas.

¿Dónde puedo obtener ayuda?

Consulte primero esta FAQ
Lea la documentación
Busque en issues existentes
Abra un nuevo issue con detalles
Únase a nuestras discusiones comunitarias

¿Por qué Swift en lugar de Python/JavaScript?

Swift ofrece:

Rendimiento nativo de macOS
Seguridad de tipos y concurrencia moderna
Excelente gestión de memoria
Integración perfecta con Claude Desktop
Ecosistema creciente para desarrollo del lado del servidor

¡Además, amamos Swift! 🍍

Requisitos previos

macOS 10.15 o posterior
Swift 5.5 o posterior
Xcode 13+ (para desarrollo)
Claude Desktop

Instalación

Requisitos previos

Obtenga una clave API GRATUITA de CoinPaprika (opcional pero recomendada para análisis técnico):
- Visite CoinPaprika API
- Haga clic en "Start Free" y regístrese
- Copie su clave API para el paso 3
- Nota: Los datos básicos de precios funcionan sin clave API vía DexPaprika

Instalación rápida

Clone el repositorio:

git clone https://github.com/M-Pineapple/CryptoAnalysisMCP.git
cd CryptoAnalysisMCP

Compile el proyecto:

./build-release.sh

Configure Claude Desktop agregando a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "crypto-analysis": {
      "command": "/path/to/CryptoAnalysisMCP/crypto-analysis-mcp",
      "env": {
        "COINPAPRIKA_API_KEY": "your-free-api-key-here"
      }
    }
  }
}

A partir de v1.3.0, el servidor se ejecuta en el transporte oficial mcp-swift-sdk por defecto. Para volver al transporte SimpleMCP heredado (válvula de seguridad de una versión, eliminado en v1.4), pase "args": ["--use-legacy"] en la configuración anterior.

Reinicie Claude Desktop

Instalación global (opcional)

sudo cp ./.build/release/CryptoAnalysisMCP /usr/local/bin/crypto-analysis-mcp

Luego use esto en la configuración de Claude Desktop:

{
  "mcpServers": {
    "crypto-analysis": {
      "command": "/usr/local/bin/crypto-analysis-mcp"
    }
  }
}

Uso

📝 Ejemplos de prompts

¿Nuevo en análisis de cripto? Consulte nuestra completa Guía de Prompts de Análisis de Cripto con más de 100 ejemplos de prompts para:

🏃 Day Trading
📊 Swing Trading
💼 Inversión a largo plazo
📈 Indicadores técnicos
🎯 Gestión de riesgos
¡Y mucho más!

Comandos disponibles

Una vez configurado, puede usar estos comandos en Claude:

Obtener precio actual

crypto-analysis:get_crypto_price
  symbol: "BTC"

Indicadores técnicos

crypto-analysis:get_technical_indicators
  symbol: "ETH"
  timeframe: "daily"

Detección de patrones de gráficos

crypto-analysis:detect_chart_patterns
  symbol: "SOL"
  timeframe: "4h"

Señales de trading

crypto-analysis:get_trading_signals
  symbol: "ADA"
  risk_level: "moderate"
  timeframe: "daily"

Análisis completo

crypto-analysis:get_full_analysis
  symbol: "DOT"
  timeframe: "weekly"
  risk_level: "aggressive"

Soporte y resistencia

crypto-analysis:get_support_resistance
  symbol: "MATIC"
  timeframe: "daily"

Análisis multi-timeframe

crypto-analysis:multi_timeframe_analysis
  symbol: "AVAX"

Comandos de liquidez y DEX

Obtener liquidez de token

crypto-analysis:get_token_liquidity
  symbol: "PEPE"
  network: "ethereum" (optional)

Buscar tokens por red

crypto-analysis:search_tokens_by_network
  network: "solana"
  query: "meme" (optional)
  limit: 20

Comparar precios en DEX

crypto-analysis:compare_dex_prices
  symbol: "SHIB"
  network: "ethereum"

Obtener pools de red

crypto-analysis:get_network_pools
  network: "ethereum"
  sort_by: "volume_usd"
  limit: 10

Obtener redes disponibles

crypto-analysis:get_available_networks

💡 Ejemplos rápidos

Aquí hay algunos prompts en lenguaje natural que puede usar:

1. Análisis rápido

"Give me a quick technical analysis of [SYMBOL]"
"Is [SYMBOL] bullish or bearish right now?"
"What's the trend for [SYMBOL]?"

2. Enfoque en day trading

"Analyze [SYMBOL] for day trading opportunities"
"Show me scalping levels for [SYMBOL] today"
"What are the intraday support and resistance for [SYMBOL]?"

3. Análisis de swing trading

"Provide swing trading setup for [SYMBOL] with 3-7 day outlook"
"Analyze [SYMBOL] patterns on daily timeframe for swing trades"
"Give me entry, stop loss, and targets for swing trading [SYMBOL]"

4. Análisis institucional completo

"Do a complete Wall Street analyst report on [SYMBOL]"
"Analyze [SYMBOL] like a hedge fund would"
"Give me all technical indicators, patterns, and signals for [SYMBOL]"

5. Estrategias basadas en riesgo

"Show me conservative trading strategy for [SYMBOL]"
"What's the aggressive play on [SYMBOL]?"
"Give me risk-adjusted entries for [SYMBOL]"

6. Solicitudes de indicadores específicos

"What's the RSI and MACD saying about [SYMBOL]?"
"Check Bollinger Bands squeeze on [SYMBOL]"
"Are there any chart patterns forming on [SYMBOL]?"

7. Análisis de monedas meme y tokens DEX

"What's the price of WOJAK?"
"Analyze that new PEPE fork on Ethereum"
"Show me price data for [obscure token]"
"Track this Uniswap token: [contract address]"

8. Analítica de liquidez y DEX

"What's the liquidity for SHIB across all DEXes?"
"Show me the top pools on Solana"
"Compare PEPE prices on different DEXes"
"Find high liquidity meme coins on BSC"
"Which DEX has the best price for ETH?"
"Show me all tokens on Arbitrum with >$1M liquidity"

💡 Reemplace [SYMBOL] con cualquier ticker de criptomoneda (BTC, ETH, SOL, etc.)

👉 Vea más de 100 ejemplos en nuestra Guía de Prompts de Análisis de Cripto

Criptomonedas Soportadas

El MCP soporta más de 7 MILLONES de tokens a través de nuestro sistema de doble proveedor:

CoinPaprika (Principal): más de 2,500 criptomonedas principales con análisis técnico completo
DexPaprika (Respaldo): más de 7 millones de tokens DEX en más de 23 blockchains - ¡NO SE REQUIERE API KEY!

El MCP automáticamente:

Verifica CoinPaprika primero para tokens establecidos (mejores datos, más funciones)
Recurre a DexPaprika para cualquier token no encontrado
Almacena en caché los resultados para un rendimiento óptimo
Funciona solo con el símbolo del ticker

Redes Soportadas vía DexPaprika:

Ethereum, BSC, Polygon, Arbitrum, Optimism, Base
Solana, Avalanche, Fantom, Aptos, Sui
¡Y más de 12 cadenas adicionales!

¡Solo usa cualquier símbolo de ticker - si existe en cualquier DEX, lo encontraremos!

Configuración

API Key (Opcional pero Recomendada)

⚠️ Importante:

Los datos básicos de precios funcionan SIN API key vía DexPaprika
Las funciones de análisis técnico aún requieren una API key GRATUITA de CoinPaprika

Obtén tu API key GRATUITA:

Visita CoinPaprika API
Haz clic en "Start Free"
Crea una cuenta
Copia tu API key

Añadir a Claude Desktop:

Opción 1 - Variable de Entorno (Recomendada):

{
  "mcpServers": {
    "crypto-analysis": {
      "command": "/path/to/crypto-analysis-mcp",
      "env": {
        "COINPAPRIKA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Opción 2 - Entorno del Sistema:

export COINPAPRIKA_API_KEY="your-api-key-here"

Transporte

CryptoAnalysisMCP v1.3+ se ejecuta en el mcp-swift-sdk oficial (v0.12.1) por defecto. Se conserva un transporte SimpleMCP heredado dentro del árbol por una versión como opción de exclusión:

Predeterminado (recomendado): no se necesita ninguna flag.
Excluirse: añade "args": ["--use-legacy"] a tu configuración de Claude Desktop.
--use-sdk: aceptado como no-op para compatibilidad con versiones anteriores v1.2.x; emite una advertencia de obsolescencia única a stderr. Se eliminará en v1.4.

Ambos transportes exponen las mismas 16 herramientas con los mismos esquemas de entrada (verificado por una prueba de integración en cada compilación). Diferencias en el formato de cable:

El SDK serializa JSON con claves ordenadas.
El SDK emite "description": null para herramientas sin descripción; la ruta heredada omite la clave.

Ninguna diferencia es semánticamente significativa, pero cualquiera que compare su tráfico JSON-RPC entre versiones debería tenerlo en cuenta.

Compatibilidad de Estilo de Trading

Conclusión: Si eres un day trader, DEBES obtener la suscripción Pro. No hay solución alternativa.

Niveles Gratis vs de Pago

Timeframes

Nivel Gratis (Sin API Key):

daily - Solo velas diarias ✅

Nivel Pro ($99/mes) - Todos los timeframes:

5m - Velas de 5 minutos
15m - Velas de 15 minutos
30m - Velas de 30 minutos
1h - Velas de 1 hora
4h - Velas de 4 horas
daily - Velas diarias
weekly - Velas semanales

💡 Nota: Intentar usar cualquier timeframe que no sea 'daily' sin una clave Pro resultará en un error.

Niveles de Riesgo

conservative - Menor riesgo, enfoque en señales fuertes
moderate - Enfoque equilibrado (predeterminado)
aggressive - Mayor riesgo, señales más sensibles

Desarrollo

Compilación desde el Código Fuente

# Clone the repository
git clone https://github.com/M-Pineapple/CryptoAnalysisMCP.git
cd CryptoAnalysisMCP

# Build debug version
swift build

# Build release version
swift build -c release

# Run tests
swift test

Estructura del Proyecto

CryptoAnalysisMCP/
├── Sources/
│   └── CryptoAnalysisMCP/
│       ├── Main.swift                    # Entry point
│       ├── SimpleMCP.swift               # MCP protocol implementation
│       ├── CryptoDataProvider.swift      # CoinPaprika API integration
│       ├── DexPaprikaDataProvider.swift  # 🆕 DexPaprika integration
│       ├── TechnicalAnalyzer.swift       # Indicators & calculations
│       ├── ChartPatternRecognizer.swift  # Pattern detection
│       ├── SupportResistanceAnalyzer.swift # Support/resistance levels
│       ├── AnalysisFormatters.swift      # Output formatting
│       └── Models.swift                  # Data models
├── Tests/                                # Unit tests
├── Package.swift                         # Swift package manifest
└── README.md                             # This file

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Haz un fork del repositorio
Crea tu rama de características (git checkout -b feature/AmazingFeature)
Haz commit de tus cambios (git commit -m 'Add some AmazingFeature')
Haz push a la rama (git push origin feature/AmazingFeature)
Abre un Pull Request

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

Agradecimientos

Construido con Swift y el Model Context Protocol
Impulsado por la API de CoinPaprika para datos de criptomonedas
🆕 Mejorado con DexPaprika para más de 7 millones de tokens DEX
Algoritmos de análisis técnico basados en estándares de la industria
¡Agradecimiento especial al equipo de CoinPaprika por su apoyo!

Solución de Problemas

El MCP no aparece en Claude

Asegúrate de que la ruta en claude_desktop_config.json sea absoluta
Verifica que el binario tenga permisos de ejecución: chmod +x crypto-analysis-mcp
Reinicia Claude Desktop después de los cambios de configuración

Límites de Tasa de API

El nivel gratuito de CoinPaprika tiene límites de tasa. Si encuentras errores 402, considera:

Usar el timeframe diario (el más compatible con el nivel gratuito)
Añadir una API key para límites más altos
Implementar limitación de solicitudes

Problemas de Compilación

Si encuentras errores de compilación:

Asegúrate de que Swift 5.5+ esté instalado: swift --version
Limpia la compilación: swift package clean
Actualiza las dependencias: swift package update

💖 Apoya Este Proyecto

Si CryptoAnalysisMCP ha ayudado a mejorar tu flujo de trabajo de análisis de criptomonedas o te ha ahorrado tiempo con indicadores técnicos, considera apoyar su desarrollo:

Tu apoyo me ayuda a:

Mantener y mejorar CryptoAnalysisMCP con nuevas funciones
Mantener el proyecto de código abierto y gratuito para todos
Dedicar más tiempo a atender solicitudes de usuarios y correcciones de errores
Explorar nuevos indicadores y técnicas de análisis

¡Gracias por considerar apoyar mi trabajo! 🙏

Soporte

Para problemas, preguntas o sugerencias, abre un issue en GitHub.

Conéctate

Sígueme para actualizaciones y perspectivas de análisis de criptomonedas:

🐦 Twitter/X: @m_pineapple__
🐙 GitHub: @M-Pineapple

Hecho con ❤️ por 🍍