mshojaei77/reactmcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

143 stars 29 forks Качество 77 Тренд 20MIT

Repository Install

mshojaei77/reactmcp — это кандидат на MCP-сервер, импортированный из https://github.com/mshojaei77/reactmcp.

Обзор

mshojaei77/reactmcp — это кандидат на MCP-сервер, импортированный из https://github.com/mshojaei77/reactmcp.

Обзор (машинный перевод)

ReActMCP Web Search — это сервер MCP (Model Context Protocol), который интегрирует возможности веб-поиска в ваш фреймворк AI-ассистента. Он использует Exa API для выполнения как базового, так и продвинутого веб-поиска, возвращая результаты в реальном времени с форматом markdown, включая заголовки, URL-адреса, даты публикации и сводки контента.

Этот репозиторий является частью более широкого проекта ReActMCP, который объединяет различные инструменты и серверы MCP, предоставляя вашему AI-ассистенту широкий спектр возможностей.

Содержание

Особенности
Требования
Установка
Конфигурация
Переменные среды
Конфигурация MCP
Системный запрос
Использование
Запуск веб-поискового сервера
Тестирование инструментов
Устранение неисправностей
Лицензия
Вклад

Особенности

Базовый веб-поиск: Выполняйте простые поиски с помощью Exa API.
Расширенный веб-поиск: Используйте дополнительные опции фильтрации, такие как ограничения домена, требования к включению текста и фильтры дат.
Markdown Output: Форматируйте результаты поиска в Markdown, чтобы легко включать заголовки, URL и резюме.
Интеграция с MCP: Легко добавьте этот инструмент в вашу экосистему серверов MCP для помощи с многофункциональным ИИ.

Требования

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального 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.

Features
Requirements
Installation
Configuration
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

Clone the Repository

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

Create a Virtual Environment (Optional but recommended)

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

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",

Открыть полный README на GitHub

Установка

docker run --rm -i -e EXA_API_KEY=your_exa_api_key_here reactmcp-exa:local

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "websearch": {
         "command": "python",
         "args": ["path/to/servers/exa_web_search.py"]
       }
  }
}