ReActMCP Web Search

ReActMCP Web Search is an MCP (Model Context Protocol) server that integrates web search capabilities into your AI assistant framework. It leverages the Exa API to perform both basic and advanced web searches, returning real-time, markdown-formatted results including titles, URLs, publication dates, and content summaries.

This repository is part of the broader ReActMCP project that connects various MCP tools and servers to empower your AI assistant with a wide range of capabilities.

---

Table of Contents

• Features
• Requirements
• Installation
• Configuration
  • Environment Variables
  • MCP Configuration
  • System Prompt
• Usage
  • Running the Web Search Server
  • Testing the Tools
• Troubleshooting
• License
• Contributing

---

Features

• Basic Web Search: Perform simple searches using the Exa API.
• Advanced Web Search: Use additional filtering options such as domain restrictions, text inclusion requirements, and date filters.
• Markdown Output: Format search results in Markdown to easily incorporate titles, URLs, and summaries.
• MCP Integration: Easily add this tool into your MCP server ecosystem for multi-tool AI assistance.

---

Requirements

• Python 3.8+
• python-dotenv
• exa-py (Exa API client)
• firecrawl-py (Firecrawl API client)
• Other dependencies that may be required by your MCP framework

---

Installation

1. Clone the Repository

   git clone https://github.com/mshojaei77/ReActMCP.git
   cd ReActMCP
   

2. Create a Virtual Environment (Optional but recommended)

   python -m venv venv
   source venv/bin/activate  # On Windows use: venv\Scripts\activate
   

3. Install Dependencies

   uv pip install -r requirements.txt
   

---

Configuration

Environment Variables

Create a .env file in the project root directory with at least the following variable:

EXA_API_KEY=your_exa_api_key_here
OPENAI_API_KEY=...

This key is required by the Exa API for performing web searches.

MCP Configuration

The MCP configuration file mcp_config.json defines the settings and tools available to your MCP server. An example configuration is provided:

{
  "websearch": {
    "script": "web_search.py",
    "encoding_error_handler": "ignore",
    "description": "Web search capability using Exa API that provides real-time internet search results. Supports both basic and advanced search with filtering options including domain restrictions, text inclusion requirements, and date filtering. Returns formatted results with titles, URLs, publication dates, and content summaries.",
    "required_env_vars": ["EXA_API_KEY"],
    "active": true
  },
  "settings": {
    "model": "gpt-4o",
    "system_prompt_path": "system_prompt.txt"
  }
}

You can personalize or extend this configuration by modifying parameters such as default number of results or adding new MCP tools.

System Prompt