1.0.5 • Published 2 months ago
@siddhantxh/exa-search v1.0.5
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 contentnum_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 searchexclude_domains
(string[], optional): Domains to exclude from searchstart_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
- Clone the repository
- Install dependencies:
npm install
- Build the project:
npm run build
- Start the server:
npm start
License
MIT