Coin MCP Server

Coin MCP Server

Un servidor de Model Context Protocol que proporciona acceso a los datos de criptomonedas de CoinMarketCap. Este servidor permite que aplicaciones impulsadas por IA obtengan listados de criptomonedas, cotizaciones e información detallada sobre diversas monedas.

Herramientas disponibles

• listing-coins - Obtiene una lista paginada de todas las criptomonedas activas con los datos de mercado más recientes.

  • start (entero, opcional): Desplazamiento del inicio (índice basado en 1) de la lista paginada de elementos a devolver.
  • limit (entero, opcional): Número de resultados a devolver (predeterminado: 10, máximo: 5000).
  • price_min (número, opcional): Precio mínimo en USD para filtrar resultados.
  • price_max (número, opcional): Precio máximo en USD para filtrar resultados.
  • market_cap_min (número, opcional): Capitalización de mercado mínima para filtrar resultados.
  • market_cap_max (número, opcional): Capitalización de mercado máxima para filtrar resultados.
  • convert (cadena, opcional): Calcular cotizaciones de mercado en múltiples monedas.
  • sort (cadena, opcional): Campo por el cual ordenar la lista de criptomonedas.
  • sort_dir (cadena, opcional): Dirección para ordenar las criptomonedas (asc o desc).

• get-coin-info - Recupera información detallada sobre una criptomoneda específica.

  • id (cadena, opcional): Uno o más ID de criptomonedas de CoinMarketCap separados por comas.
  • slug (cadena, opcional): Una lista de slugs de criptomonedas separados por comas.
  • symbol (cadena, opcional): Uno o más símbolos de criptomonedas separados por comas.

• get-coin-quotes - Obtiene las cotizaciones de mercado más recientes para una o más criptomonedas.

  • id (cadena, opcional): Uno o más ID de CoinMarketCap de criptomonedas separados por comas.
  • slug (cadena, opcional): Una lista de slugs de criptomonedas separados por comas.
  • symbol (cadena, opcional): Uno o más símbolos de criptomonedas separados por comas.

Instalación

Instalación mediante Smithery

Para instalar Cryptocurrency Data para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install coin-api-mcp --client claude

Compilar el servidor

Clona este repositorio y compila e instala el programa con tu intérprete de Python predeterminado (recomendado).

git clone https://github.com/longmans/coin_api_mcp.git
cd coin_api_mcp
uv build
uv pip install .

Después de la instalación, puedes ejecutarlo como script usando:

python -m coin_api_mcp

Configuración

Clave de API

El servidor requiere una clave de API de CoinMarketCap para funcionar. Puedes obtener una en el sitio web de CoinMarketCap. La clave de API se puede proporcionar de dos maneras:

1. Como variable de entorno:

export COINMARKETCAP_API_KEY=your_api_key_here

2. Como argumento de línea de comandos:

python -m coin_api_mcp --api-key=your_api_key_here

Configurar para Claude.app

Añade a tu configuración de Claude:

"mcpServers": {
  "coin_api": {
    "command": "python",
    "args": ["-m", "coin_api_mcp"]
  },
  "env": {
        "COINMARKETCAP_API_KEY": "your_api_key_here"
  }
}

Si ves algún problema, es posible que quieras usar la ruta completa del intérprete de Python que estás usando. Puedes ejecutar which python para averiguar la ruta exacta si es necesario.

Recuerda configurar la variable de entorno COINMARKETCAP_API_KEY o proporcionarla mediante el argumento --api-key.

Depuración

Puedes usar el inspector de MCP para depurar el servidor

Contribuciones

Animamos a contribuir para ayudar a expandir y mejorar Coin MCP Server. Ya sea que quieras añadir nuevas capacidades de búsqueda, mejorar la funcionalidad existente o mejorar la documentación, tu aportación es valiosa.

Para ver ejemplos de otros servidores MCP y patrones de implementación, consulta: https://github.com/modelcontextprotocol/servers

¡Las solicitudes de extracción (pull requests) son bienvenidas! No dudes en contribuir con nuevas ideas, correcciones de errores o mejoras para hacer que Coin MCP Server sea aún más potente y útil.

Licencia

Coin MCP Server está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.