CoinGecko

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

# Option 1: Install and run with npx
npx coingecko-api-server

# Option 2: Clone and install manually
git clone https://github.com/yourusername/coingecko-api-server.git
cd coingecko-api-server
npm install
npm run setup
npm start

📦 Instalación

Opción 1: Usar npx (recomendado)

La forma más rápida de empezar:

npx coingecko-api-server

Esto hará lo siguiente:

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

Opción 2: Instalación manual

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

# Clone the repository
git clone https://github.com/yourusername/coingecko-api-server.git
cd coingecko-api-server

# Install dependencies
npm install

# Run the setup script
npm run setup

# Start the server
npm start

⚙️ Configuración

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

Variable	Descripción	Por defecto
`PORT`	Puerto del servidor	`3000`
`COINGECKO_API_KEY`	Clave API de CoinGecko Pro (opcional)	-
`CACHE_DURATION`	Duración de la caché en segundos	`60`
`LOG_LEVEL`	Nivel de registro (error, advertencia, información, depuración)	`info`

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:

curl "http://localhost:3000/api/simple/price?ids=bitcoin&vs_currencies=usd"

Respuesta:

{
  "bitcoin": {
    "usd": 45678.12
  }
}

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

curl "http://localhost:3000/api/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=5&page=1"

🤖 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

Punto final JSON-RPC : /rpc : maneja llamadas de métodos de clientes de IA
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:

Característica	API gratuita	API Pro
Límite de velocidad	~30 llamadas/minuto	~500 llamadas/minuto
Limitación de la API	Sí	No
Apoyo	Comunidad	Prioridad
Frescura de datos	10-30 minutos	1-2 minutos
Precio	Gratis	Suscripción

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

🔧 Solución de problemas

Asunto	Solución
Errores de limitación de velocidad	Considere actualizar a Pro API o ajustar la frecuencia de sus solicitudes
Conexión rechazada	Asegúrese de que el servidor se esté ejecutando en el puerto especificado
Errores de autenticación	Comprueba tu clave API en el archivo .env
Datos faltantes	Verifique los parámetros en su solicitud

🧪 Desarrollo

# Run in development mode with hot reload
npm run dev

# Run tests
npm test

# Build for production
npm run build

🔄 Cómo funciona

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

Enrutamiento de solicitudes : maneja solicitudes entrantes de clientes RESTful y JSON-RPC
Selección de API : elige entre API gratuitas y Pro según la configuración
Gestión del límite de velocidad : implementa una limitación inteligente de solicitudes
Procesamiento de respuesta : formatea y devuelve datos en una estructura consistente
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]