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