Servidor API CoinGecko MCP

Acceso sin inconvenientes a datos de criptomonedas para sistemas y aplicaciones de IA

Características • Inicio rápido • Instalación • Configuración • Referencia de API • Integración con MCP • API Pro • Solución de problemas • Licencia

🌟 Descripción general

El Servidor API MCP de CoinGecko es una potente solución Node.js lista para producción que proporciona acceso fluido a los datos del mercado de criptomonedas mediante una elegante interfaz API RESTful y MCP (Programa de Componentes del Mercado). Conecta sistemas de IA como Claude con datos de criptomonedas en tiempo real, a la vez que gestiona todas las complejidades de los límites de velocidad de la API, las opciones de respaldo y la gestión de errores.

✨ Características principales

• 🔄 Compatibilidad con API dual : se integra perfectamente con las API gratuitas y Pro de CoinGecko
• 🧠 Integración de IA : Implementación completa del protocolo MCP para asistentes de IA
• 🛡️ Respaldo inteligente : cambia automáticamente entre API para evitar la limitación de velocidad
• ⚡ Rendimiento optimizado : manejo eficiente de solicitudes y almacenamiento en caché de respuestas
• 📊 Datos completos : acceso a todas las métricas esenciales de criptomonedas
• 🔌 Interfaz sencilla : puntos finales RESTful intuitivos y métodos JSON-RPC
• 🚦 Manejo robusto de errores : mensajes de error claros con códigos de estado apropiados
• 🧩 Fácil implementación : configuración mínima con proceso de configuración guiado
• 📘 Documentación extensa : instrucciones de uso claras y ejemplos

🚀 Inicio rápido

📦 Instalación

Opción 1: Usar npx (recomendado)

La forma más rápida de empezar:

Esto hará lo siguiente:

1. 📥 Descargar e instalar el servidor
2. 🧰 Ejecute un asistente de configuración interactivo
3. 🔑 Solicita tu clave API de CoinGecko (opcional)
4. 🚀 Iniciar el servidor automáticamente

Opción 2: Instalación manual

Para tener más control sobre el proceso de instalación:

⚙️ Configuración

El servidor se configura utilizando variables de entorno en el archivo .env :

Referencia de API

Puntos finales RESTful

Puntos finales básicos

• GET /api/ping - Verificar el estado del servidor API

Datos de precios

• GET /api/simple/price - Obtener datos de precios de monedas específicas
  • Parámetros de consulta: ids , vs_currencies , include_market_cap , include_24hr_vol , include_24hr_change , include_last_updated_at , precision

Datos de la moneda

• GET /api/coins/markets - Obtener datos del mercado de monedas
  • Parámetros de consulta: vs_currency , ids , category , order , per_page , page , sparkline , price_change_percentage

Datos de mercado

• GET /api/global - Obtener datos globales de criptomonedas
• GET /api/search/trending - Obtener monedas de tendencia

Ejemplos

Obtenga el precio de Bitcoin en USD:

Respuesta:

Obtenga las 5 principales criptomonedas por capitalización de mercado:

🤖 Integración de IA (MCP)

Este servidor implementa el protocolo Marketplace Component Program (MCP), que permite que sistemas de IA como Claude accedan a datos de criptomonedas.

Puntos de integración MCP

1. Punto final JSON-RPC : /rpc : maneja llamadas de métodos de clientes de IA
2. Definición del esquema : /mcp/schema : define las herramientas y los parámetros disponibles

Métodos MCP disponibles

• ping - Verificar el estado de la API
• getPrice : obtén datos de precios de criptomonedas específicas
• getSupportedVsCurrencies - Obtener la lista de monedas admitidas
• getCoinMarkets - Obtenga datos del mercado de monedas
• getGlobal - Obtenga datos globales de criptomonedas
• getTrending - Consigue monedas de tendencia

Para obtener instrucciones de integración detalladas, consulte MCP_INTEGRATION.md .

Beneficios de la API Pro

Este servidor admite tanto la API de CoinGecko Pro como la API gratuita:

Para obtener más detalles sobre la configuración de la API Pro, consulte USING_COINGECKO_PRO.md .

🔧 Solución de problemas

🧪 Desarrollo

🔄 Cómo funciona

El servidor actúa como un middleware entre sus aplicaciones y la API de CoinGecko:

1. Enrutamiento de solicitudes : maneja solicitudes entrantes de clientes RESTful y JSON-RPC
2. Selección de API : elige entre API gratuitas y Pro según la configuración
3. Gestión del límite de velocidad : implementa una limitación inteligente de solicitudes
4. Procesamiento de respuesta : formatea y devuelve datos en una estructura consistente
5. Manejo de errores : proporciona información detallada de errores para la solución de problemas

📱 Casos de uso

• Asesores financieros impulsados por IA : habilite los sistemas de IA para acceder a datos criptográficos en tiempo real
• Paneles de inversión : cree paneles de criptomonedas con acceso confiable a datos
• Rastreadores de cartera : cree aplicaciones para monitorear sus tenencias de criptomonedas
• Herramientas de análisis de mercado : Desarrollar herramientas para el análisis técnico y fundamental.
• Bots de trading : potencie los sistemas de trading automatizados con datos del mercado

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🙏 Agradecimientos

• CoinGecko para la API integral de datos de criptomonedas
• Antrópico para Claude AI y el programa MCP
• A la comunidad de código abierto por sus invaluables contribuciones

⬆ Volver arriba

Hecho con ❤️ por [Su organización]