Frequently Asked Questions (FAQ) - MCP SearXNG Enhanced Server

Q: What is an MCP Server? A: MCP stands for Model Context Protocol. An MCP server acts as a bridge, allowing AI models to access and interact with external data sources and tools, providing them with necessary context.

Q: What is SearXNG and how is it used in this MCP server? A: SearXNG is a privacy-respecting metasearch engine. This MCP server uses SearXNG’s API to provide web search capabilities with category support.

Q: What are the key features of this enhanced MCP server? A: The key features include category-aware web search, website content scraping with citation metadata, in-memory caching, domain-based rate limiting, and a timezone-aware date/time tool.

Q: How do I install and run this MCP server? A: The server can be installed and run using Docker or natively with Python. Detailed instructions are provided in the documentation, including how to configure it with an MCP client.

Q: What environment variables are required to configure the server? A: At a minimum, SEARXNG_ENGINE_API_BASE_URL is required to point to your SearXNG instance. Other environment variables control caching, rate limiting, timeouts, and more.

Q: How does the server handle rate limiting? A: The server uses domain-based rate limiting to prevent excessive requests to the same domain within a time window, avoiding potential IP blocking.

Q: How does caching work in this server? A: The server utilizes in-memory caching with automatic freshness validation. This stores frequently accessed content in memory for faster retrieval, and stale content is refreshed automatically.

Q: What error handling mechanisms are in place? A: The server implements robust error handling with custom exception types, providing informative messages for configuration errors, connection failures, web scraping issues, and rate limit exceedances.

Q: Can I use this MCP server with the UBOS platform? A: Yes, this MCP server is designed to seamlessly integrate with the UBOS platform, enhancing the capabilities of AI Agents within the UBOS ecosystem.

Q: What categories are available for web search? A: Available categories include general web pages, images, videos, files, maps, and social media posts.

Q: How do I configure the server using an ods_config.json file? A: Create an ods_config.json file in the project’s root directory (or the path specified by the ODS_CONFIG_PATH environment variable). Environment variables take precedence over values in this file.

Q: What should I do if I cannot connect to SearXNG? A: Ensure your SearXNG instance is running and that the SEARXNG_ENGINE_API_BASE_URL environment variable points to the correct endpoint.

Q: How can I contribute to the project? A: You can contribute by submitting pull requests, reporting issues, and providing feedback on the project’s GitHub repository.