Searxng Mcp
What is Searxng Mcp
searxng-mcp is a Model Context Protocol (MCP) server designed to interface language models with the SearXNG search engine, allowing language models to perform web searches using the Model Context Protocol standard.
Use cases
Use cases include enhancing conversational AI with real-time search capabilities, providing information retrieval in customer support systems, and enabling research tools to access the web dynamically.
How to use
To use searxng-mcp, clone the repository, install the dependencies, and run the server using Node.js. Configure it with environment variables to set the SearXNG host, port, and protocol as needed.
Key features
Key features include a clean interface for sending search queries, support for various search parameters, caching of results, and easy deployment via Docker.
Where to use
searxng-mcp can be used in applications that require integration of language models with web search capabilities, such as chatbots, virtual assistants, and other AI-driven applications.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Searxng Mcp
searxng-mcp is a Model Context Protocol (MCP) server designed to interface language models with the SearXNG search engine, allowing language models to perform web searches using the Model Context Protocol standard.
Use cases
Use cases include enhancing conversational AI with real-time search capabilities, providing information retrieval in customer support systems, and enabling research tools to access the web dynamically.
How to use
To use searxng-mcp, clone the repository, install the dependencies, and run the server using Node.js. Configure it with environment variables to set the SearXNG host, port, and protocol as needed.
Key features
Key features include a clean interface for sending search queries, support for various search parameters, caching of results, and easy deployment via Docker.
Where to use
searxng-mcp can be used in applications that require integration of language models with web search capabilities, such as chatbots, virtual assistants, and other AI-driven applications.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
SearXNG Model Context Protocol Server
A Model Context Protocol (MCP) server for interfacing language models with SearXNG search engine.
Description
This server enables language models to perform web searches through SearXNG using the Model Context Protocol standard. It provides a clean interface for language models to send search queries to SearXNG and receive formatted results.
Installation
# Clone the repository
git clone https://github.com/aeon-seraph/searxng-mcp.git
cd searxng-mcp
# Install dependencies
npm install
# Build the project
npm run build
Requirements
- Node.js 16+
- A running SearXNG instance (by default at http://localhost:8888)
Usage
# Run the server
node build/index.js
The server will run on stdio, making it suitable for integration with MCP-compatible language models.
Configuration
The server can be configured using environment variables:
| Variable | Description | Default |
|---|---|---|
| SEARXNG_PROTOCOL | Protocol to use (http/https) | http |
| SEARXNG_HOST | SearXNG host | localhost |
| SEARXNG_PORT | SearXNG port | 8888 |
| CACHE_TTL | Cache time-to-live in milliseconds | 600000 (10 minutes) |
| MAX_CACHE_SIZE | Maximum number of cached queries | 100 |
Example:
SEARXNG_HOST=mysearx.example.com SEARXNG_PORT=443 SEARXNG_PROTOCOL=https node build/index.js
Docker
The project includes a Dockerfile for easy deployment:
# Build the Docker image
docker build -t searxng-mcp .
# Run the container
docker run -e SEARXNG_HOST=mysearx.example.com -e SEARXNG_PROTOCOL=https searxng-mcp
Search Parameters
The search function supports the following parameters:
query(required): The search query stringcategories: Comma-separated list of search categoriespageno: Search page number (default: 1)time_range: Time range for results (“day”, “week”, “month”, “year”)raw_json: Return raw JSON response instead of formatted text (default: false)
License
MIT
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
