Mrunmays Exa MCP Server

🚀 Exa MCP Server 🔍

A Model Context Protocol (MCP) server enables AI assistants like Claude to leverage Exa's powerful web search API. This setup allows AI models to access real - time web information in a secure and controlled manner.

🚀 Quick Start

Demo Video

https://www.loom.com/share/ac676f29664e4c6cb33a2f0a63772038?sid=0e72619f-5bfc-415d-a705-63d326373f60

✨ Features

What is MCP? 🤔

Model Context Protocol (MCP) is a system that allows AI applications (such as Claude Desktop) to connect to external tools and services. Through MCP, AI assistants can interact with external data sources more efficiently.

Exa MCP Server 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: Fully implemented in TypeScript with comprehensive type checking.

📦 Installation

Prerequisites 🔧

• Node.js: Ensure the latest version of Node.js and npm is installed.
• Claude Desktop: Need to install and run Claude Desktop.
• Exa API Key: Register an Exa account to obtain a valid API key.

Installation Steps 📋

1. Install via NPM

npm install -g exa-mcp-server

2. Install via Smithery

smithery add exa

3. Manual Installation

1. Download and extract the source code package.
2. Navigate to the project directory and run:

   npm install
   

📚 Documentation

Configuration Guide 🎯

Modify the Claude Configuration File

Locate or create the claude_desktop_config.json file and add the following content:

{
  "mcp": {
    "servers": [
      {
        "name": "exa_mcp",
        "type": "custom",
        "uri": "localhost:1234",
        "api_key": "your_exa_api_key_here"
      }
    ]
  }
}

Usage Guide 💻

Example Queries

- Query for tech news: `What's the latest news about AI?`
- Search for technical documentation: `Find me the documentation for Node.js v18`

#### Workflow
1. **Handle search requests**
2. **Invoke the Exa API**
3. **Return formatted results to Claude**
4. **Cache search results**

### Feature Highlights ✨
- **Web Search**: Supports natural language queries.
- **Error Recovery**: Intelligent retry mechanism.
- **Rate Limiting**: Automatically handles API rate limits.

### Troubleshooting 🔧
#### Common Issues

1. **Server not found**
   - Ensure the npm link is correctly set up.
   - Check the syntax of the Claude configuration file.
   - Confirm that Node.js is installed correctly.

2. **API key issues**
   - Confirm that the API key is valid.
   - Check if the key is correctly configured.
   - Ensure there are no spaces or quotes in the key.

3. **Connection issues**
   - Restart Claude Desktop completely.
   - View the logs:
     ```
     # macOS
     tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
     ```

#### Get Help
Refer to the [MCP documentation](https://modelcontextprotocol.io)

## 📄 License

### Acknowledgments 🙏
Thanks to the following support:
- **Exa AI**: Provides a powerful search API.
- **Model Context Protocol**: Defines the MCP standard.
- **Anthropic**: Develops Claude Desktop