Web3 Research MCP

Una herramienta gratuita y local para la investigación profunda de criptomonedas.

GitHub
162
Prueba este MCPPatrocinado

Documentación

Web3 Research MCP — deep research for crypto, free and fully local. An MCP server with 13 tools across CoinGecko, CoinMarketCap, DeFiLlama and more; no API key required.

Danos una estrella ❤️ → Star Web3 Research MCP on GitHub web3-research-mcp on npm @aaronjmars on X

Investigación profunda para cripto: gratis y totalmente local.
Un servidor MCP local que investiga cualquier token en CoinGecko, CoinMarketCap, DeFiLlama y más: sin clave API, nada sale de tu máquina.

stars forks npm license

## 🚀 Vista previa

Preview Preview2

🧠 Características

  • Investigación integral: Recopila información detallada sobre cualquier token de criptomoneda
  • Análisis de múltiples fuentes: Investiga en varias fuentes, incluyendo CoinGecko, CoinMarketCap, DeFiLlama y más
  • Informes estructurados: Genera informes detallados que cubren fundamentos técnicos, datos de mercado, sentimiento social y más
  • Gestión de recursos: Almacena automáticamente los resultados de búsqueda y el contenido como referencia
  • Seguimiento de estado: Realiza un seguimiento del progreso de la investigación a través de diferentes etapas y secciones

📋 Requisitos

  • Node.js (v16 o superior)

🔧 Instalación y configuración

Instalación mediante Smithery

Para instalar web3-research-mcp para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install web3-research-mcp --client claude

🔌 Uso con Claude Desktop

Edita tu archivo de configuración de Claude Desktop

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Añade esto a tu archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "web3-research-mcp": {
      "command": "npx",
      "args": ["-y", "web3-research-mcp@latest"]
    }
  }
}

Luego reinicia Claude Desktop

🔌 Uso con Cursor

Ve a: Configuración -> Configuración de Cursor -> MCP -> Añadir nuevo servidor MCP global. Pega esto en tu archivo ~/.cursor/mcp.json de Cursor. Consulta la documentación de MCP de Cursor para más información.

{
  "mcpServers": {
    "web3-research-mcp": {
      "command": "npx",
      "args": ["-y", "web3-research-mcp@latest"]
    }
  }
}

Luego reinicia Cursor

🛠️ Herramientas

create-research-plan

Crea un plan de investigación estructurado para un token.

Parámetros:

  • tokenName: Nombre completo del token
  • tokenTicker: Símbolo del ticker del token

search

Realiza una búsqueda web y devuelve los resultados.

Parámetros:

  • query: Consulta de búsqueda
  • searchType: Tipo de búsqueda (web, noticias, imágenes, videos)

research-with-keywords

Busca un token con palabras clave específicas y guarda los resultados.

Parámetros:

  • tokenName: Nombre del token
  • tokenTicker: Símbolo del ticker
  • keywords: Matriz de palabras clave para buscar

update-status

Actualiza el estado de una sección de investigación.

Parámetros:

  • section: Nombre de la sección a actualizar (p. ej., 'projectInfo', 'technicalFundamentals')
  • status: Nuevo estado de la sección (planned, in_progress, completed)

fetch-content

Obtiene contenido de una URL y lo guarda como recurso.

Parámetros:

  • url: URL de la que obtener contenido
  • format: Formato de salida (text, html, markdown, json)

list-resources

Lista todos los recursos disponibles que se han guardado.

search-source

Busca información sobre un token en una fuente específica.

Parámetros:

  • tokenName: Nombre del token
  • tokenTicker: Símbolo del ticker
  • source: Fuente a buscar (p. ej., 'CoinGecko', 'DeFiLlama', 'News')

research-source

Busca en una fuente específica un token y guarda el contenido de la página del mejor resultado como recurso markdown.

Parámetros:

  • tokenName: Nombre del token
  • tokenTicker: Símbolo del ticker del token
  • source: Fuente a investigar (p. ej., 'IQ Wiki', 'CoinMarketCap')

coingecko-data

Obtiene datos de mercado en vivo directamente de la API pública de CoinGecko: precio, capitalización de mercado, cambios a 24h/7d/30d, ATH/ATL, suministro circulante, direcciones de contratos en varias cadenas y enlaces sociales/de desarrollo. Evita los problemas de error 403 del scraping HTML.

Parámetros:

  • tokenName: Nombre completo del token (p. ej., 'Bitcoin')
  • tokenTicker: Símbolo del ticker (p. ej., 'BTC')

No se requiere clave API. Utiliza el nivel gratuito público (~30 solicitudes/min).

Opcional: establece COINGECKO_API_KEY en el entorno para usar una clave API Pro de CoinGecko. Cuando se establece, las solicitudes se envían a https://pro-api.coingecko.com/api/v3 con el encabezado x-cg-pro-api-key. Las solicitudes expiran después de 15 segundos.

coingecko-search

Busca en el índice de monedas de CoinGecko y devuelve coincidencias candidatas con sus IDs de CoinGecko. Útil cuando el ticker es ambiguo (p. ej., múltiples tokens con el mismo símbolo).

Parámetros:

  • query: Consulta de búsqueda: nombre, ticker o dirección de contrato

coingecko-tickers

Obtiene listados de intercambio activos para un token desde CoinGecko: qué CEX/DEX comercian el par, volumen USD a 24h por plataforma, último precio, diferencial de oferta/demanda, puntuación de confianza y URL de comercio. Ordenado por volumen USD a 24h descendente; se filtran anomalías y operaciones obsoletas. Evita el scraping HTML para la pregunta "¿dónde se negocia realmente este token?".

Parámetros:

  • tokenName: Nombre completo del token (p. ej., 'Bitcoin')
  • tokenTicker: Símbolo del ticker (p. ej., 'BTC')
  • limit: Cuántas plataformas principales devolver (predeterminado 15, máximo 50)

No se requiere clave API. Utiliza el nivel gratuito público. Las solicitudes expiran después de 15 segundos.

defillama-data

Obtiene datos de protocolo directamente de la API pública de DeFiLlama: TVL total, TVL máximo histórico con fecha, cambio de TVL a 30/90/365 días frente al actual, capitalización de mercado (cuando esté disponible; DeFiLlama la omite para muchos protocolos), desglose de TVL por cadena, tarifas (24h/7d/30d/todo el tiempo), direcciones de tokens, rondas de financiación y enlaces. Evita el scraping HTML para la consulta más común de protocolos DeFi.

Parámetros:

  • tokenName: Nombre completo del protocolo/token (p. ej., 'Uniswap')
  • tokenTicker: Símbolo del ticker (p. ej., 'UNI')

No se requiere clave API. Utiliza la API pública gratuita. Las solicitudes expiran después de 15 segundos. El índice de protocolos se almacena en caché durante 5 minutos por proceso para evitar saturar /protocols en cada llamada.

defillama-search

Busca en el índice de protocolos de DeFiLlama y devuelve coincidencias candidatas con sus slugs, TVL y categoría. Útil cuando el ticker es ambiguo (p. ej., múltiples protocolos con nombres similares).

Parámetros:

  • query: Consulta de búsqueda: nombre del protocolo, ticker o slug

📝 Prompts

token-research

Inicia una investigación integral sobre un token de criptomoneda.

Parámetros:

  • tokenName: Nombre completo del token de criptomoneda
  • tokenTicker: Símbolo del ticker del token (p. ej., BTC, ETH)

🧠 Cómo funciona

  1. Cuando comienza la investigación, se crea un plan estructurado que cubre todos los aspectos del token
  2. El servidor realiza búsquedas en múltiples fuentes para obtener información
  3. Los resultados de búsqueda se almacenan como recursos que pueden ser referenciados
  4. La investigación avanza a través de diferentes secciones, con seguimiento de estado
  5. Se genera un informe integral que cubre todos los aspectos del token

⚠️ Limitaciones

  • Algunos sitios web bloquean el scraping web, por lo que la obtención directa de contenido puede fallar con errores 403
  • Depende de los resultados de búsqueda, que pueden no ser siempre integrales
  • Pueden aplicarse límites de velocidad a las operaciones de búsqueda

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT: consulta el archivo LICENSE para más detalles.

Creado por Aaron Elijah Mars, fundador de Aeon y MiroShark · @aaronjmars