EXA Search MCP Server

A Model Context Protocol (MCP) server that provides semantic web search capabilities using the EXA API.

Installation

npm install -g @mcp-servers/exa-search

Configuration

The server requires an EXA API key. You can get one from EXA's website.

Set your API key as an environment variable:

export EXA_API_KEY=your_api_key_here

Usage

As a CLI Tool

Once installed globally and configured with an API key, you can run the server:

exa-mcp

In Your MCP Configuration

Add this to your .cursor/mcp.json:

{
  "mcpServers": {
    "exa-search": {
      "command": "exa-mcp",
      "env": {
        "EXA_API_KEY": "your_api_key_here"
      }
    }
  }
}

As a Library

You can also use the server programmatically:

import { createExaServer } from '@mcp-servers/exa-search';
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const apiKey = process.env.EXA_API_KEY;
const server = createExaServer(apiKey);
const transport = new StdioServerTransport();
await server.connect(transport);

API

The server provides a single tool:

search

Performs a semantic search using the EXA API.

Parameters:

• query (string): Search query to find relevant web content
• num_results (number, optional): Number of search results to return (default: 10, max: 50)
• search_type (string, optional): Type of search to perform ("neural" or "keyword", default: "neural")
• include_domains (string[], optional): Domains to include in search
• exclude_domains (string[], optional): Domains to exclude from search
• start_crawl_date (string, optional): Start date for crawled content (YYYY-MM-DD)
• end_crawl_date (string, optional): End date for crawled content (YYYY-MM-DD)
• include_text (boolean, optional): Include page text in results (default: true)
• include_highlights (boolean, optional): Include highlighted snippets (default: true)

Returns:

• Search results including titles, URLs, snippets, and highlights

Development

1. Clone the repository
2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Start the server:

npm start

License

MIT