ReActMCP

MCP.Pizza Chef: mshojaei77

Live web search sits behind two abilities: a plain one returning the top few results with a short summary of each, and a filtered one that can limit results to particular sites, require a phrase to appear, or ignore anything older than a set number of days. The same repository carries a second, separate page-reading server with five more abilities. Both lean on outside paid services — Exa for searching, Firecrawl for reading pages — so every search spends credit from your account.

Web/Research

Use This MCP server To

Check the latest news on a topic before I write about it Search only within a handful of sites I trust Find articles published on a subject in the last week Look up a fact that changed after my assistant's training Gather sourced links with a short summary of each

README

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

  • 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


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

ReActMCP FAQ

Do I need a key?
Yes, an Exa key for the search tools. Exa gives new accounts some free credit, and after that every search draws on paid credit, with summaries costing more.
What happens if I forget the key?
The search server refuses to start at all rather than starting and failing later, so put the key in place before you first launch it.
Can I use this to check today's news before writing something?
Yes — ask for recent coverage and you get titles, links, publication dates, and a short summary of each result in one reply.
Is it a client or a server?
Its own description calls it a client, but the part you install hands search abilities to your assistant, which makes it a server. The bundled chat program is the client half, and it is optional.
How many things can it do?
Two for search. A second, separate server in the same repository adds five page-reading abilities, but it needs its own Firecrawl key and is started on its own.
Do I need an OpenAI key as well?
Not for the search tools. The example settings list one, but it is only used by the optional bundled chat program, not by anything your assistant calls.
How hard is the setup?
Developer-level. You download the code, install Python packages, write a settings file holding your key, and start the server yourself, or build the container image supplied.
Which apps does it work in?
Claude Desktop is mentioned, and any app that launches a local tool should work. A container image is included for hosts that prefer that route.