ReActMCP Web Search MCP sunucusu
Bir AI istemcisinin Exa API aracılığıyla temel veya gelişmiş web aramaları yapmasını sağlar ve sonuçları Markdown formatında döndürür.
Ayrıca bilinen adı mshojaei77/ReActMCP
- Yıldızlar
- 144
- Araçlar
- 2
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 22 Tem 2026
- Lisans
- MIT
ReActMCP Web Search MCP nedir?
Bir AI istemcisinin Exa API aracılığıyla temel veya gelişmiş web aramaları yapmasını sağlar ve sonuçları Markdown formatında döndürür. 2 araç sunar; örneğin search_web, advanced_search_web.
Özet, projenin README dosyasından oluşturuldu
ReActMCP Web Search MCP sunucusu hakkında
ReActMCP Web Search, yapay zeka asistanlarına gerçek zamanlı internet bilgisi sağlanmasına olanak tanır. Bu MCP server, yerel veya konteynerize edilmiş AI istemcinizi Exa API'ye bağlayarak modellerin güncel gerçeklere ve web içeriklerine erişmesini sağlar. Çoklu araç kullanan yapay zeka çerçeveleri geliştiren ve asistanlarının yapılandırılmış veriler aracılığıyla canlı web'e erişmesine ihtiyaç duyan geliştiriciler için tasarlanmıştır.
Kullanıcılar, search_web aracını kullanarak basit sorgular gerçekleştirebilir veya daha hassas kontrol için advanced_search_web aracını kullanabilirler. Gelişmiş işlevsellik; sonuçları daraltmak için alan adı kısıtlamalarına, belirli metinlerin dahil edilmesine ve tarih filtrelemeye imkan tanır. Tüm bulgular; başlıklar, URL'ler, yayın tarihleri ve içerik özetleri dahil olmak üzere Markdown formatında döndürülür, bu da bir yapay zekanın verileri ayrıştırmasını ve sunmasını kolaylaştırır.
Kurulum için ortam değişkenleri aracılığıyla sağlanan geçerli bir Exa API anahtarı gereklidir. Sunucu, Python 3.8+ kullanılarak yerel olarak çalıştırılabilir veya Docker aracılığıyla dağıtılabilir. Yerel yapılandırma dosyasında sunucu komutunu yapılandırarak Claude Desktop gibi istemcilerle entegre edilebilir.
Neler yapabilirsiniz
- 1Zamana duyarlı bilgileri geri getirmeAsistana, belirli bir gün sayısı içinde gerçekleşmiş haberleri veya olayları araması talimatını verin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
ReActMCP Web Search MCP araçları 2
README dosyasından algılandısearch_webadvanced_search_web
| search_web | — | |
| advanced_search_web | — |
Yapılandırma
EXA_API_KEYOPENAI_API_KEY
| Ad | Açıklama | Sunucu |
|---|---|---|
| EXA_API_KEY | — | |
| OPENAI_API_KEY | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirmshojaei77/reactmcp is public and reachablegithub.com/mshojaei77/reactmcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-07-22github.com/mshojaei77/reactmcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok2 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
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 soruları
ReActMCP Web Search MCP hangi araçları sunar?
2 araç sunar; bunlar arasında search_web, advanced_search_web yer alır.
ReActMCP Web Search hangi arama araçlarını sunar?
Temel aramalar için search_web ve filtrelenmiş aramalar için advanced_search_web araçlarını sunar. Gelişmiş araç; alan adı kısıtlamaları, gerekli metin ve tarih filtreleri gibi seçenekleri destekler.
ReActMCP Web Search kullanmak için bir API anahtarına ihtiyacım var mı?
Evet, bir Exa API anahtarı gereklidir ve EXA_API_KEY ortam değişkeninden okunur. README dosyası, bu anahtarı bir .env dosyasına koymanızı veya docker run ile iletmenizi önerir.
ReActMCP Web Search'ü Docker ile nasıl çalıştırırım?
İmajı oluşturun ve çalışma zamanında EXA_API_KEY değerini ileterek stdio üzerinden çalıştırın. İmaj giriş noktası servers/exa_web_search.py dosyasıdır.
ReActMCP Web Search'ü Claude Desktop'a nasıl eklerim?
Claude Desktop yapılandırmasındaki mcpServers altına bir websearch girişi ekleyin; komut olarak python'ı, argüman olarak ise servers/exa_web_search.py yolunu kullanın.
Gelişmiş arama ile neleri filtreleyebilirim?
Gelişmiş arama; sonuçları belirli alan adlarıyla kısıtlama, belirli bir metni dahil etme zorunluluğu ve güncel sonuçlar için max_age_days parametresi dahil olmak üzere tarihle sınırlama gibi filtreleri destekler.