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.

Related MCP server: Crypto Trader MCP Tool

✨ 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:

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:

# 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 :

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

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

# 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:

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]