ReActMCP Web Search MCP server
Exa API를 통해 AI 클라이언트가 기본 또는 고급 웹 검색을 수행하고 Markdown 형식의 결과를 반환합니다.
다른 이름 mshojaei77/ReActMCP
- 스타
- 144
- Tools
- 2
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 7월 22일
- 라이선스
- MIT
ReActMCP Web Search MCP란?
Exa API를 통해 AI 클라이언트가 기본 또는 고급 웹 검색을 수행하고 Markdown 형식의 결과를 반환합니다. 2개 도구를 제공합니다. 예: search_web, advanced_search_web.
프로젝트 README에서 생성된 요약
ReActMCP Web Search MCP server 정보
ReActMCP Web Search는 AI 어시스턴트에게 실시간 인터넷 정보를 제공합니다. 이 MCP server는 로컬 또는 컨테이너화된 AI 클라이언트를 Exa API에 연결하여 모델이 최신 사실과 웹 콘텐츠를 검색할 수 있도록 합니다. 구조화된 데이터를 통해 어시스턴트가 라이브 웹에 접속해야 하는 멀티 툴 AI 프레임워크 개발자를 위해 설계되었습니다.
사용자는 search_web 도구를 사용하여 간단한 쿼리를 수행하거나, 더 세밀한 제어가 가능한 advanced_search_web 도구를 활용할 수 있습니다. 고급 기능은 도메인 제한, 특정 텍스트 포함, 날짜 필터링을 통해 검색 결과를 좁힐 수 있게 해줍니다. 모든 검색 결과는 제목, URL, 발행 날짜, 콘텐츠 요약을 포함한 Markdown 형식으로 반환되어 AI가 파싱하고 제시하기 용이합니다.
설정하려면 환경 변수를 통해 유효한 Exa API 키를 제공해야 합니다. 서버는 Python 3.8 이상을 사용하여 로컬에서 실행하거나 Docker를 통해 배포할 수 있습니다. 로컬 설정 파일에 서버 명령을 구성하여 Claude Desktop과 같은 클라이언트와 통합할 수 있습니다.
활용 사례
- 1시의성 있는 정보 검색특정 기간 내에 발생한 뉴스나 이벤트를 찾도록 어시스턴트에게 지시합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
ReActMCP Web Search MCP 도구 2
README에서 감지됨search_webadvanced_search_web
| search_web | — | |
| advanced_search_web | — |
구성
EXA_API_KEYOPENAI_API_KEY
| 이름 | 설명 | 유형 |
|---|---|---|
| EXA_API_KEY | — | |
| OPENAI_API_KEY | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능mshojaei77/reactmcp is public and reachablegithub.com/mshojaei77/reactmcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-07-22github.com/mshojaei77/reactmcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음2 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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
- 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",
"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 might have changed since your training data, use the appropriate search tool to find the most recent and relevant information.
2. Use `search_web` for general queries and `advanced_search_web` with appropriate filters for more specific needs.
3. Formulate precise search queries to maximize result relevance.
4. For recent information, use the `max_age_days` parameter in advanced search to limit results to recent publications.
5. When targeting specific sources, use the `include_domains` parameter to focus your search.
6. Cite sources by including URLs from search results.
7. For insufficient or contradictory results, acknowledge limitations and explain findings.
8. Break down complex topics into organized sections.
9. Provide balanced perspectives on controversial topics.
10. Be transparent about uncertainty rather than making up information.
11. Maintain a helpful, informative, and conversational tone.
## Response Quality Standards
Your responses should be well-structured, factually accurate, and tailored to the user's level of understanding on the topic. Use the web search capabilities as your primary tools for accessing current information before responding to time-sensitive or factual queries.
Feel free to adjust the system prompt to align with your desired assistant behavior.
Docker and Glama
The published container runs the Exa MCP server over stdio. Build and run it with the API key supplied at runtime:
docker build -t reactmcp-exa:local .
docker run --rm -i -e EXA_API_KEY=your_exa_api_key_here reactmcp-exa:local
The exact container command for MCP hosts is:
docker run --rm -i -e EXA_API_KEY=your_exa_api_key_here reactmcp-exa:local
The Docker image entry point is servers/exa_web_search.py. main.py is the
optional OpenAI/LangGraph host and is not the container MCP entry point.
The repository includes glama.json with the maintainer identity used by
Glama's claim flow. After merging it, repeat the Glama claim flow so Glama
syncs the metadata and Dockerfile.
To validate the image with MCP Inspector:
npx @modelcontextprotocol/inspector docker run --rm -i -e EXA_API_KEY=your_exa_api_key_here reactmcp-exa:local
Run the Inspector command from a terminal with Docker and Node.js installed.
Usage
Running the Web Search Server
The MCP servers is implemented in servers directory. To run a server, simply execute it :
python servers/exa_web_search.py
This command will start the MCP server which listens for requests and exposes the following tools:
- search_web: Perform basic web searches.
- advanced_search_web: Perform advanced web searches with filtering options.
Testing the Tools
Within servers/exa_web_search.py, a test function test_search() is provided (currently commented out) to demonstrate basic usage of the search capabilities. You can run this test by uncommenting the test execution block and using Python's asyncio runner:
if __name__ == "__main__":
import asyncio
# Uncomment the following line to perform a test search
# asyncio.run(test_search())
mcp.run()
This will print search results for sample queries and help you verify that the tool is functioning as expected.
Claude Desktop Configuration:
Configure Claude Desktop to use this server by adding the following to your configuration:
{
"mcpServers": {
"websearch": {
"command": "python",
"args": ["path/to/servers/exa_web_search.py"]
}
}
}
Troubleshooting
- Missing EXA_API_KEY: Ensure that the
.envfile is properly set up with your valid Exa API key. - Dependency Issues: Verify that all necessary Python packages are installed (check your
requirements.txtfile). Reinstall packages if needed. - API Errors: If you encounter errors during web searches, check your network connection and verify the Exa API status.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Contributing
Contributions are welcome! If you have suggestions, bug fixes, or improvements, please open an issue or submit a pull request.
Happy coding and enjoy building your personalized, multi-tool AI assistant with ReActMCP Web Search! 🚀😊
Star History
ReActMCP Web Search MCP 질문
ReActMCP Web Search MCP는 어떤 도구를 제공하나요?
2개 도구를 제공합니다. 예: search_web, advanced_search_web.
ReActMCP Web Search는 어떤 검색 도구를 제공하나요?
기본 검색을 위한 search_web과 필터링된 검색을 위한 advanced_search_web을 제공합니다. 고급 도구는 도메인 제한, 필수 텍스트, 날짜 필터와 같은 옵션을 지원합니다.
ReActMCP Web Search를 사용하려면 API 키가 필요한가요?
네, Exa API 키가 필요하며 EXA_API_KEY 환경 변수에서 읽어옵니다. README를 참고하여 .env 파일에 저장하거나 docker run 시 전달하십시오.
Docker로 ReActMCP Web Search를 실행하려면 어떻게 하나요?
이미지를 빌드한 후 실행 시 EXA_API_KEY를 전달하여 stdio를 통해 실행합니다. 이미지 entry point는 servers/exa_web_search.py입니다.
Claude Desktop에 ReActMCP Web Search를 추가하려면 어떻게 하나요?
Claude Desktop 설정의 mcpServers 아래에 websearch 항목을 추가합니다. command는 python을 사용하고 argument로 servers/exa_web_search.py 경로를 지정합니다.
고급 검색에서는 어떤 필터링이 가능한가요?
고급 검색은 특정 도메인으로 결과 제한, 특정 텍스트 포함, 날짜 필터링을 지원하며, 최신 결과를 위한 max_age_days 파라미터도 제공합니다.