Theishangoswami Exa MCP Server

🚀 Exa MCP Server 🔍

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

Demo Video

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

🚀 Quick Start

What is MCP? 🤔

The Model Context Protocol (MCP) is a system that allows AI applications (such as Claude Desktop) to connect to external tools and services. It provides a clear and secure way for AI assistants to use local services and APIs while keeping users in control.

What are the functions of this server? 🚀

The Exa MCP server:

• Enables AI assistants to perform web searches via Exa's powerful search API.
• Provides structured search results, including titles, URLs, and content snippets.
• Handles rate limits and error situations smoothly.

📦 Installation

Prerequisites 📋

Before you start, make sure you have the following:

• Node.js (v18 or higher)
• Claude Desktop installed
• An Exa API key
• Git installed

You can verify the installation of Node.js by running the following command:

node --version  # Should display v18.0.0 or higher

Installation Steps 🛠️

1. Clone the repository:

git clone https://github.com/exa-labs/exa-mcp-server.git
cd exa-mcp-server

2. Install dependencies:

npm install --save axios dotenv

3. Build the project:

npm run build

4. Create a global link:

npm link

📚 Documentation

Configuration

Configuration of Claude Desktop

The Exa MCP server needs to be configured in Claude Desktop. Here is a configuration example:

{
  "mcpVersion": "0.1",
  "servers": [
    {
      "name": "exaMCP",
      "url": "http://localhost:5002",
      "token": "your_api_token"
    }
  ]
}

Settings of the Exa MCP Server

Please refer to the MCP documentation for how to configure the Exa MCP server.

Troubleshooting 🚨

Common Issues

1. Server not found?
   • Ensure that the Exa MCP server is started and running.
   • Check the network connection.
   • View the log file for more information:

     # macOS
     tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
     

Getting Help

If you encounter problems, please refer to the MCP documentation.

🙏 Acknowledgments

• The powerful search API provided by Exa AI (exa.ai)
• The MCP specification of the Model Context Protocol
• Claude Desktop developed by Anthropic (anthropic.com)