1.0.5 • Published 2 months ago

@siddhantxh/exa-search v1.0.5

Weekly downloads
-
License
MIT
Repository
-
Last release
2 months ago

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
  1. Build the project:
npm run build
  1. Start the server:
npm start

License

MIT

1.0.5

2 months ago

1.0.2

2 months ago

1.0.1

2 months ago

1.0.0

2 months ago