Exa

API de Pesquisa Exa AI

GitHub
6
Experimente este MCPPatrocinado

Documentação

Servidor MCP Exa 🔍

Um servidor Model Context Protocol (MCP) permite que assistentes de IA como o Claude usem a API de busca Exa AI para pesquisas na web. Essa configuração permite que modelos de IA obtenham informações da web em tempo real de forma segura e controlada.

Vídeo de demonstração https://www.loom.com/share/ac676f29664e4c6cb33a2f0a63772038?sid=0e72619f-5bfc-415d-a705-63d326373f60

O que é MCP? 🤔

O Model Context Protocol (MCP) é um sistema que permite que aplicativos de IA, como o Claude Desktop, se conectem a ferramentas externas e fontes de dados. Ele fornece uma maneira clara e segura para assistentes de IA trabalharem com serviços locais e APIs, mantendo o usuário no controle.

O que este servidor faz? 🚀

O servidor MCP Exa:

  • Permite que assistentes de IA realizem pesquisas na web usando a poderosa API de busca da Exa
  • Fornece resultados de busca estruturados, incluindo títulos, URLs e trechos de conteúdo
  • Lida com limitação de taxa e casos de erro de forma elegante

Pré-requisitos 📋

Antes de começar, certifique-se de ter:

Você pode verificar sua instalação do Node.js executando:

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:

Você pode pesquisar por desenvolvimentos recentes em computação quântica?

Pesquise e resuma as últimas notícias sobre startups de inteligência artificial em Nova York.

Encontre e analise artigos de pesquisa recentes sobre soluções para mudanças climáticas.

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

Obtendo Ajuda

Se você encontrar problemas, revise a Documentação MCP

Agradecimentos 🙏