mcp-search
An intelligent MCP (Model Context Protocol) server that helps you discover and research MCP servers using the powerful Exa AI search engine. Built with FastMCP for seamless integration with AI assistants like Claude, Cursor, and more.
claude mcp add --transport stdio haran2001-mcp-search-server python mcp_search_server.py \ --env EXA_API_KEY="Your Exa API key (required)"
How to use
MCP Search Server is an intelligent server that helps you discover, analyze, and compare MCP servers using Exa's search capabilities. Built with FastMCP integration, it can perform searches for MCPs, retrieve detailed information about a specific MCP, find similar MCPs, answer questions about MCPs, and categorize MCPs by functional areas. Core tools include search_mcps for broad queries, get_mcp_details to inspect a repository in depth, find_similar_mcps to surface alternatives, ask_mcp_question for direct Q&A, and categorize_mcps to explore by category. Once running, you can interact with the server to quickly surface MCPs that fit your requirements, understand their installation notes, and compare options side-by-side.
How to install
Prerequisites:
- Python 3.10+ (recommended)
- Exa API Key (required)
- Internet connection for search functionality
- Optional: Git for cloning, FastMCP CLI for testing
Method 1: Direct Download and Setup
-
Create and navigate to the project directory mkdir mcp-search-server cd mcp-search-server
-
Install dependencies pip install -r requirements.txt
Or install manually
pip install fastmcp>=2.0.0 httpx>=0.25.0
-
Set up environment variable
Linux/Mac
export EXA_API_KEY=your_exa_api_key_here
Windows Command Prompt
set EXA_API_KEY=your_exa_api_key_here
Windows PowerShell
$env:EXA_API_KEY="your_exa_api_key_here"
-
Run the server python mcp_search_server.py
Method 2: Using Virtual Environment (Recommended)
-
Create virtual environment and activate python -m venv mcp-search-env
Linux/Mac:
source mcp-search-env/bin/activate
Windows:
mcp-search-env\Scripts\activate
-
Install dependencies pip install -r requirements.txt
-
Run the server python mcp_search_server.py
Exa API Key Setup
- Get API Key from Exa Dashboard and copy it (starts with exa_)
- Set environment variable as shown in the installation steps above
Verification and Testing
- Basic installation check: python --version and import checks
- API Key test: verify EXA_API_KEY is set
- Server test: run test_mcp_search.py or start the server directly
Additional notes
Tips and common issues:
- Ensure EXA_API_KEY is set in the environment before starting the server; the server will use this to access Exa services.
- If you encounter dependency issues, verify you are using Python 3.10+ and reinstall requirements.
- For local development, consider using a virtual environment to isolate dependencies.
- If the server cannot reach Exa APIs, check your network settings or proxy configuration.
- The mcp_search_server.py script assumes the repository structure from the project; if you fork or relocate files, update paths accordingly.
- When testing with the FastMCP CLI, ensure the CLI version is compatible with FastMCP endpoints used by this server.
Related MCP Servers
mcp-vegalite
MCP server from isaacwasserman/mcp-vegalite-server
github-chat
A Model Context Protocol (MCP) for analyzing and querying GitHub repositories using the GitHub Chat API.
nautex
MCP server for guiding Coding Agents via end-to-end requirements to implementation plan pipeline
pagerduty
PagerDuty's official local MCP (Model Context Protocol) server which provides tools to interact with your PagerDuty account directly from your MCP-enabled client.
futu-stock
mcp server for futuniuniu stock
mcp -boilerplate
Boilerplate using one of the 'better' ways to build MCP Servers. Written using FastMCP