Servidor Exa MCP 🔍

Un servidor de Protocolo de Contexto de Modelo (MCP) permite a asistentes de IA como Claude usar la API de Búsqueda de IA de Exa para búsquedas web. Esta configuración permite a los modelos de IA obtener información web en tiempo real de forma segura y controlada.

Vídeo de demostración https://www.loom.com/share/ac676f29664e4c6cb33a2f0a63772038?sid=0e72619f-5bfc-415d-a705-63d326373f60

¿Qué es MCP? 🤔

El Protocolo de Contexto de Modelo (MCP) es un sistema que permite que las aplicaciones de IA, como Claude Desktop, se conecten a herramientas y fuentes de datos externas. Ofrece una forma clara y segura para que los asistentes de IA trabajen con servicios y API locales, manteniendo al usuario en control.

¿Qué hace este servidor? 🚀

El servidor Exa MCP:

• Permite que los asistentes de IA realicen búsquedas web utilizando la potente API de búsqueda de Exa
• Proporciona resultados de búsqueda estructurados que incluyen títulos, URL y fragmentos de contenido.
• Almacena en caché búsquedas recientes como recursos de referencia
• Maneja con elegancia los casos de limitación de velocidad y de error
• Admite el rastreo web en tiempo real para contenido nuevo

Prerrequisitos 📋

Antes de comenzar, asegúrese de tener:

• Node.js (v18 o superior)
• Claude Desktop instalado
• Una clave API de Exa
• Git instalado

Puede verificar su instalación de Node.js ejecutando:

Instalación 🛠️

Instalación de NPM

Uso de herrería

Para instalar el servidor Exa MCP para Claude Desktop automáticamente a través de Smithery :

Instalación manual

1. Clonar el repositorio:

2. Instalar dependencias:

3. Construir el proyecto:

4. Crea un enlace global (esto hace que el servidor sea ejecutable desde cualquier lugar):

Configuración ⚙️

1. Configure Claude Desktop para que reconozca el servidor Exa MCP

Puedes encontrar claude_desktop_config.json dentro de la configuración de la aplicación Claude Desktop:

Abra la aplicación Claude Desktop y habilite el Modo de desarrollador desde la barra de menú superior izquierda.

Una vez habilitado, abre Configuración (también desde la barra de menú superior izquierda) y navega hasta las Opciones de desarrollador, donde encontrarás el botón Editar configuración. Al hacer clic, se abrirá el archivo claude_desktop_config.json, que te permitirá realizar las modificaciones necesarias.

O (si desea abrir claude_desktop_config.json desde la terminal)

Para macOS:

1. Abra la configuración de Claude Desktop:

Para Windows:

1. Abra la configuración de Claude Desktop:

2. Agregue la configuración del servidor Exa:

Reemplace your-api-key-here con su clave API de Exa real desde dashboard.exa.ai/api-keys .

3. Reinicie Claude Desktop

Para que los cambios surtan efecto:

1. Salir completamente de Claude Desktop (no solo cerrar la ventana)
2. Inicie Claude Desktop nuevamente
3. Busque el ícono 🔌 para verificar que el servidor Exa esté conectado

Uso 🎯

Una vez configurado, puedes pedirle a Claude que realice búsquedas web. Aquí tienes algunos ejemplos:

El servidor hará lo siguiente:

1. Procesar la solicitud de búsqueda
2. Consulta la API de Exa con configuraciones óptimas (incluido el rastreo en vivo)
3. Devolver resultados formateados a Claude
4. Almacenar en caché la búsqueda para futuras referencias

Características ✨

• Herramienta de búsqueda web simplificada : permite a Claude buscar en la web con solo un parámetro de consulta
• Parámetros de búsqueda personalizables : controle la cantidad de resultados y la estrategia de rastreo en vivo
• Rastreo automático en vivo : utiliza rastreo en tiempo real según una estrategia específica
• Parámetros óptimos preestablecidos : utiliza los mejores valores predeterminados para el recuento de resultados y los límites de caracteres
• Almacenamiento en caché de búsqueda : guarda búsquedas recientes como recursos de referencia
• Manejo de errores : maneja con elegancia los errores de API y los límites de velocidad
• Seguridad de tipos : implementación completa de TypeScript con validación de Zod
• Cumplimiento de MCP : implementa completamente la última especificación del protocolo MCP

Pruebas con MCP Inspector 🔍

Puede probar el servidor directamente utilizando el Inspector MCP:

Esto abre una interfaz interactiva donde puede explorar las capacidades del servidor, ejecutar consultas de búsqueda y ver resultados de búsqueda almacenados en caché.

Solución de problemas 🔧

Problemas comunes

1. Servidor no encontrado
   • Verifique que el enlace npm esté configurado correctamente
   • Compruebe la sintaxis de configuración de Claude Desktop
   • Asegúrese de que Node.js esté instalado correctamente
2. Problemas con la clave API
   • Confirme que su EXA_API_KEY sea válida
   • Compruebe que EXA_API_KEY esté configurado correctamente en la configuración de Claude Desktop
   • Verifique que no haya espacios ni comillas alrededor de la clave API
3. Problemas de conexión
   • Reiniciar Claude Desktop por completo
   • Consultar los registros de Claude Desktop: GXP18

Obtener ayuda

Si encuentra problemas, revise la documentación de MCP o visite las discusiones de GitHub para obtener soporte de la comunidad.

Agradecimientos 🙏

• Exa AI por su potente API de búsqueda
• Protocolo de contexto de modelo para la especificación MCP
• Antrópico para Claude Desktop