Exa MCP Server

Official
MIT License
1,858
510
  • Apple

local-only server

The server can only run on the client’s local machine because it depends on local resources.

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:

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

node --version # Should show v18.0.0 or higher

Instalación 🛠️

Instalación de NPM

npm install -g exa-mcp-server

Uso de herrería

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

npx -y @smithery/cli install exa --client claude

Instalación manual

  1. Clonar el repositorio:
git clone https://github.com/exa-labs/exa-mcp-server.git cd exa-mcp-server
  1. Instalar dependencias:
npm install
  1. Construir el proyecto:
npm run build
  1. Crea un enlace global (esto hace que el servidor sea ejecutable desde cualquier lugar):
npm link

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:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Para Windows:

  1. Abra la configuración de Claude Desktop:
code %APPDATA%\Claude\claude_desktop_config.json

2. Agregue la configuración del servidor Exa:

{ "mcpServers": { "exa": { "command": "npx", "args": ["/path/to/exa-mcp-server/build/index.js"], "env": { "EXA_API_KEY": "your-api-key-here" } } } }

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

3. Herramientas disponibles y selección de herramientas

El servidor Exa MCP incluye las siguientes herramientas:

  • web_search : Realiza búsquedas web en tiempo real con resultados optimizados y extracción de contenido.
  • research_paper_search : Búsqueda especializada centrada en artículos académicos y contenido de investigación.
  • twitter_search : Búsqueda dedicada a Twitter/X.com que encuentra tweets, perfiles y conversaciones.
  • company_research : herramienta integral de investigación de empresas que rastrea los sitios web de las empresas para recopilar información detallada sobre las mismas.
  • rastreo : extrae contenido de URL específicas, útil para leer artículos, archivos PDF o cualquier página web cuando tienes la URL exacta.
  • competitor_finder : identifica a los competidores de una empresa buscando empresas que ofrecen productos o servicios similares.

Puede elegir qué herramientas habilitar agregando el parámetro --tools a su configuración de Claude Desktop:

Especifique qué herramientas habilitar:

{ "mcpServers": { "exa": { "command": "npx", "args": [ "/path/to/exa-mcp-server/build/index.js", "--tools=web_search,research_paper_search,twitter_search,company_research,crawling,competitor_finder" ], "env": { "EXA_API_KEY": "your-api-key-here" } } } }

Para habilitar varias herramientas, utilice una lista separada por comas:

{ "mcpServers": { "exa": { "command": "npx", "args": [ "/path/to/exa-mcp-server/build/index.js", "--tools=web_search,research_paper_search,twitter_search,company_research,crawling,competitor_finder" ], "env": { "EXA_API_KEY": "your-api-key-here" } } } }

Si no especifica ninguna herramienta, se utilizarán todas las herramientas habilitadas de forma predeterminada.

4. 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 a través de NPX

Si prefieres ejecutar el servidor directamente, puedes usar npx:

# Run with all tools enabled by default npx exa-mcp-server # Enable specific tools only npx exa-mcp-server --tools=web_search # Enable multiple tools npx exa-mcp-server --tools=web_search,research_paper_search # List all available tools npx exa-mcp-server --list-tools

Uso 🎯

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

Can you search for recent developments in quantum computing?
Search for and summarize the latest news about artificial intelligence startups in new york.
Find and analyze recent research papers about climate change solutions.
Search Twitter for posts from @elonmusk about SpaceX.
Find tweets from @samaltman that were published in the last week about AI safety.
Research the company exa.ai and find information about their pricing and features.
Extract the content from this research paper: https://arxiv.org/pdf/1706.03762
Find competitors for a company that provides web search API services, excluding exa.ai from the results.

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

Pruebas con MCP Inspector 🔍

Puede probar el servidor directamente utilizando el Inspector MCP:

npx @modelcontextprotocol/inspector node ./build/index.js

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: GXP23

Agradecimientos 🙏

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

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.

  1. What is MCP? 🤔
    1. What does this server do? 🚀
      1. Prerequisites 📋
        1. Installation 🛠️
          1. NPM Installation
          2. Using Smithery
          3. Manual Installation
        2. Configuration ⚙️
          1. 1. Configure Claude Desktop to recognize the Exa MCP server
          2. 2. Add the Exa server configuration:
          3. 3. Available Tools & Tool Selection
          4. 4. Restart Claude Desktop
        3. Using via NPX
          1. Usage 🎯
            1. Testing with MCP Inspector 🔍
              1. Troubleshooting 🔧
                1. Common Issues
              2. Acknowledgments 🙏
                ID: 8gfe5kbp5y