================== /// MCP /// /// MCP /// ================== [server:online] [protocol:ready]
mcp-searxng
by ihor-sokoliuk
MCP server that exposes SearXNG web-search and URL-reader tools via the Model Context Protocol.
162
30
Open Source01
searxng_web_search
Execute web searches with optional pagination, time range filtering, language selection, and safe-search control
02
web_url_read
Fetch a web page by URL and convert its content to markdown
Installation
1. Clone the repository
git clone https://github.com/ihor-sokoliuk/mcp-searxng.git
cd mcp-searxng
2. Install Node.js dependencies (requires Node 18+ / npm 9+)
npm install
# or
yarn install
3. Configuration
• Copy the example environment file and edit it
• Mandatory variables
• (Optional) tweak SEARXNG_TIMEOUT, LOG_LEVEL, RATE_LIMIT, etc.
cp .env.example .env
SEARXNG_HOST=https://your-searxng.example.com
# optional – API key if your SearXNG instance enforces it
SEARXNG_API_KEY=<key>
# port exposed by the MCP server
PORT=8080
4. Run in development mode
npm run dev
# open http://localhost:8080
5. Run in production
npm run build # if the project ships a build step
npm start # launches the MCP server
# or use a process manager such as pm2 / docker compose
6. Docker (optional)
docker build -t mcp-searxng:latest .
docker run -d -p 8080:8080 -e SEARXNG_HOST=https://your-searxng.example.com mcp-searxng:latest
Documentation
License: MIT License
Updated 7/30/2025