CoinMarketCap Universal MCP Server

Servidor MCP universal de CoinMarketCap

Este proyecto es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso completo a los datos de criptomonedas de CoinMarketCap. Está diseñado para integrarse fácilmente con Cursor, lo que permite acceder a una amplia gama de datos de criptomonedas directamente desde el entorno de Cursor.

Características

• Cobertura API integral : acceso a múltiples puntos finales de API de CoinMarketCap
• Almacenamiento en caché inteligente : reduce las llamadas a la API y mejora el rendimiento
• Seguridad de tipos : compatibilidad total con TypeScript con definiciones de tipos completas
• Diseño modular : fácil de ampliar y mantener
• Manejo detallado de errores : Borrar mensajes de error y registro

Herramientas disponibles

Datos de criptomonedas

• get_cryptocurrency_listings - Obtenga los listados de criptomonedas más recientes
• get_cryptocurrency_quotes - Obtenga cotizaciones para criptomonedas específicas
• get_cryptocurrency_info - Obtener metadatos para criptomonedas
• get_cryptocurrency_market_pairs - Obtener pares de mercado para una criptomoneda
• get_cryptocurrency_ohlcv - Obtener datos históricos de OHLCV
• convert_cryptocurrency - Convierte entre criptomonedas y monedas fiduciarias

Intercambio de datos

• get_exchange_listings - Obtenga los últimos listados de intercambio
• get_exchange_info - Obtenga información detallada del intercambio
• get_exchange_map - Obtener un mapa de todos los intercambios

Datos del mercado global

• get_global_metrics : obtenga métricas del mercado global de criptomonedas

Sentimiento del mercado

• get_fear_greed_index - Obtener datos del Índice de Miedo y Avaricia

Cómo agregar al cursor MCP

Este proyecto está diseñado para integrarse perfectamente con la funcionalidad MCP de Cursor. Aquí te explicamos cómo agregarlo:

1. Clonar el repositorio e ingresar al directorio del proyecto:
   git clone https://github.com/yourusername/coinmarketcap-mcp.git cd coinmarketcap-mcp
2. Instalar dependencias:
   npm install
3. Configurar variables de entorno:
   • Cree un archivo .env en el directorio raíz del proyecto.
   • Agregue su clave API de CoinMarketCap:
     CMC_API_KEY=YOUR_COINMARKETCAP_API_KEY CACHE_ENABLED=true CACHE_TTL=300
     Reemplace YOUR_COINMARKETCAP_API_KEY con su clave API real.
4. Construya y ejecute el servidor:
   • Entorno de desarrollo:
     npm run dev
   • Entorno de producción:
     npm run build npm start
5. Agregar al cursor:
   • Cursor abierto.
   • Vaya a Configuración > MCP.
   • Agregue un nuevo servidor con la siguiente configuración:
     • Tipo: COMMAND
     • Comando: node ABSOLUTE PATH/dist/index.js

¡Ahora puedes usar todas las herramientas disponibles directamente en Cursor para acceder a los datos de CoinMarketCap!

Ejemplos de uso

Obtenga los últimos listados de criptomonedas

Obtenga cotizaciones para criptomonedas específicas

Obtenga el Índice de Miedo y Avaricia

Obtenga métricas del mercado global

Solución de problemas

Si encuentra problemas:

1. Asegúrese de tener una clave API de CoinMarketCap válida
2. Compruebe que el archivo .env esté configurado correctamente
3. Revise los registros de la consola para obtener información detallada del error
4. Asegúrese de que su plan de API tenga acceso a los puntos finales que intenta utilizar

Licencia

Instituto Tecnológico de Massachusetts (MIT)