Exa

API de Búsqueda de Exa AI

GitHub
6
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Exa 🔍

Un servidor del Protocolo de Contexto de Modelos (MCP) permite que asistentes de IA como Claude utilicen la API de Búsqueda de Exa AI para búsquedas web. Esta configuración permite que los modelos de IA obtengan información web en tiempo real de una manera segura y controlada.

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

¿Qué es MCP? 🤔

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

¿Qué hace este servidor? 🚀

El servidor MCP de Exa:

  • 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, URLs y fragmentos de contenido
  • Maneja la limitación de velocidad y los casos de error de manera elegante

Requisitos previos 📋

Antes de comenzar, asegúrate de tener:

Puedes verificar tu instalación de Node.js ejecutando:

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

Installation 🛠️

  1. Clone the repository:
git clone https://github.com/exa-labs/exa-mcp-server.git
cd exa-mcp-server
  1. Install dependencies:
npm install --save axios dotenv
  1. Build the project:
npm run build
  1. Create a global link (this makes the server executable from anywhere):
npm link

Configuration ⚙️

1. Claude Desktop Configuration

Configure Claude Desktop to recognize the Exa MCP server:

You can also find claude_desktop_config.json inside the settings of Claude Desktop app

or

For macOS:

  1. Open your Claude Desktop configuration:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

For Windows:

  1. Open your Claude Desktop configuration:
code %APPDATA%\Claude\claude_desktop_config.json
  1. Add the Exa server configuration:
{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": ["/path/to/exa-mcp-server/build/index.js"],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Replace your-api-key-here with your actual Exa API key from dashboard.exa.ai/api-keys.

2. Restart Claude Desktop

For the changes to take effect:

  1. Completely quit Claude Desktop (not just close the window)

  2. Start Claude Desktop again

  3. Look for the 🔌 icon to verify the Exa server is connected

Usage 🎯

Once configured, you can ask Claude to perform web searches. Here are some example prompts:

¿Puedes buscar desarrollos recientes en computación cuántica?

Busca y resume las últimas noticias sobre startups de inteligencia artificial en Nueva York.

Encuentra y analiza artículos de investigación recientes sobre soluciones al cambio climático.

The server will:

  1. Process the search request

  2. Query the Exa API

  3. Return formatted results to Claude

  4. Cache the search for future reference

Features ✨

  • Web Search Tool: Enables Claude to search the web using natural language queries

  • Error Handling: Gracefully handles API errors and rate limits

  • Type Safety: Full TypeScript implementation with proper type checking

Troubleshooting 🔧

Common Issues

  1. Server Not Found

    • Verify the npm link is correctly set up

    • Check Claude Desktop configuration syntax

    • Ensure Node.js is properly installed

  2. API Key Issues

    • Confirm your Exa API key is valid

    • Check the API key is correctly set in the Claude Desktop config

    • Verify no spaces or quotes around the API key

  3. Connection Issues

    • Restart Claude Desktop completely

    • Check Claude Desktop logs:

      # macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Obtener ayuda

Si encuentras problemas, revisa la Documentación de MCP

Agradecimientos 🙏