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)
• 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

   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

The system_prompt.txt file configures the behavior and tone of your AI assistant. It guides responses to be friendly, engaging, and informative, with the inclusion of emojis. An example prompt is provided:

You are a helpful, knowledgeable AI assistant with web search capabilities. Your goal is to provide accurate, comprehensive, and up-to-date information to users.
Use lots of emojis and make your responses fun and engaging.

## Available Search Tools

- `search_web`: Basic web search that returns results based on a query
- `advanced_search_web`: Advanced search with filtering options for domains, required text, and date ranges

## Guidelines for Responding to Questions

1. For current information or facts that mi

... [View full README on GitHub](https://github.com/mshojaei77/ReActMCP#readme)