SearXNG MCP Server
A Model Context Protocol server that integrates the SearXNG API, giving any MCP client private web search and URL-to-Markdown reading through your own meta-search instance.
Features
- Web search against any SearXNG instance - no third-party search API keys
- Pagination with page selection
- Filters: time range (day/month/year), language, and safe search
- URL reader: fetch any URL and convert it to Markdown
- Authentication: optional HTTP Basic Auth for protected instances
Tools
searxng_web_search
Performs a web search and returns titles, descriptions and URLs.
web_url_read
Fetches a URL and converts the HTML content to Markdown.
Configuration
Choose a public instance from searx.space or run your own.
Installation
npx
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": ["-y", "@tobioffice/mcp-searxng"],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}
npm global install
npm install -g @tobioffice/mcp-searxng
{
"mcpServers": {
"searxng": {
"command": "tobioffice-mcp-searxng",
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}
From source
git clone https://github.com/tobioffice/mcp-searxng.git
cd mcp-searxng
pnpm install
pnpm run build
node dist/index.js
Ready-to-copy client configs are included in claude_desktop_config_example.json and claude_desktop_config_with_auth.json.
Development
pnpm install
pnpm run build # compile TypeScript to dist/
pnpm run watch # compile in watch mode
License
MIT - see LICENSE.