Exa MCP Server

🚀 Exa MCP Server 🔍

An Exa Model Context Protocol (MCP) server enables AI assistants like Claude to conduct web searches using the Exa AI Search API. This setup allows AI models to access real-time information in a secure and controlled manner.

🚀 Quick Start

The Exa MCP server is designed to empower AI assistants with web search capabilities. It uses the MCP protocol to interact with external data sources, providing more accurate and relevant results.

✨ Features

• Web Search Tool: Enables Claude to perform web searches using natural language queries.
• Error Handling: Gracefully manages API errors and rate limits.
• Type Safety: Fully implemented in TypeScript with comprehensive type checking.
• Content Filtering: Automatically filters inappropriate or sensitive information.
• Result Sorting: Sorts search results based on relevance.
• Multilingual Support: Supports search requests in multiple languages.

📦 Installation

Prerequisites

• Node.js: Ensure you have the latest version of Node.js and npm installed.
• Claude Desktop: Download and install the latest version of Claude Desktop.
• Exa API Key: Obtain a valid Exa API access key.

Installation Methods

Using NPM

npm install exa-mcp-server

Using Smithery

smithery add exa

Manual Installation

1. Clone the repository:

git clone https://github.com/your-repository/exa-mcp.git

2. Navigate to the directory and install dependencies:

cd exa-mcp
npm install

📚 Documentation

Configuration Guide

Configuring Claude Desktop

Add the following configuration in Claude Settings to recognize the Exa MCP server:

{
  "mcpServers": [
    {
      "name": "Exa Search",
      "type": "SEARCH_API",
      "url": "http://localhost:3000"
    }
  ]
}

Environment Variables

Set the following environment variable to configure the Exa MCP server:

export EXA_API_KEY="your-api-key-here"

Usage Guide

Basic Usage

Claude can perform web searches as follows:

const results = await exaMcp.search("How to learn artificial intelligence");
// Returns structured results

Processing Flow

1. Analyze the search request.
2. Call the Exa API to retrieve results.
3. Format the results and return them to Claude.
4. Cache the search results for future use.

Troubleshooting

Common Issues

1. Server Not Found:
   • Ensure the npm link is correctly set up.
   • Check the syntax of the Claude Desktop configuration.
2. API Key Issues:
   • Confirm the validity of the API key.
   • Check if the key is correctly set in the configuration.

Getting Help

For further support, refer to the MCP Documentation.

📄 Acknowledgments 🙏

• Exa AI: Provides a powerful search API.
• Model Context Protocol (MCP): Establishes the specifications.
• Anthropic: Develops Claude Desktop.