SearXNG MCP Server
An MCP server implementation that integrates the SearXNG API, providing web search capabilities.
Potencia tu agente
El comando propio del publicador. No es un endpoint de PlugMCP.
Host a copy with our keys and logs.
npx -y @eyzeci/[email protected]Claude Code no tiene enlace de instalación para un comando local. Copia el comando de abajo y ejecútalo en una terminal.
claude mcp add eyzeci-mcp-searxng -- npx -y @eyzeci/mcp-searxng@0.9.1Ejecútalo en una terminal.
{ "mcpServers": { "eyzeci-mcp-searxng": { "command": "npx", "args": [ "-y", "@eyzeci/[email protected]" ] } }}claude_desktop_config.json
¿URL remota o un comando en tu máquina? En qué se diferencian las dos instalaciones
Ejecutar en PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDel publicador
An MCP server implementation that integrates the SearXNG API, providing web search capabilities.
MCP server for SearXNG integration
searxng_web_search
query (string): The search query. This string is passed to external search services.pageno (number, optional): Search page number, starts at 1 (default 1)time_range (string, optional): Filter results by time range - one of: "day", "month", "year" (default: none)language (string, optional): Language code for results (e.g., "en", "fr", "de") or "all" (default: "all")safesearch (number, optional): Safe search filter level (0: None, 1: Moderate, 2: Strict) (default: instance setting)web_url_read
url (string): The URL to fetch and processstartChar (number, optional): Starting character position for content extraction (default: 0)maxLength (number, optional): Maximum number of characters to returnsection (string, optional): Extract content under a specific heading (searches for heading text)paragraphRange (string, optional): Return specific paragraph ranges (e.g., '1-5', '3', '10-')readHeadings (boolean, optional): Return only a list of headings instead of full contentSEARXNG_URL: SearXNG instance URL (default: http://localhost:8080)
<protocol>://<hostname>[:<port>]https://search.example.comAUTH_USERNAME / AUTH_PASSWORD: HTTP Basic Auth credentials for password-protected instancesUSER_AGENT: Custom User-Agent header (e.g., MyBot/1.0)HTTP_PROXY / HTTPS_PROXY: Proxy URLs for routing traffic
http://[username:password@]proxy.host:portNO_PROXY: Comma-separated bypass list (e.g., localhost,.internal,example.com){
"mcpServers": {
"searxng": {
"command": "npx",
"args": ["-y", "mcp-searxng"],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": ["-y", "mcp-searxng"],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL",
"AUTH_USERNAME": "your_username",
"AUTH_PASSWORD": "your_password",
"USER_AGENT": "MyBot/1.0",
"HTTP_PROXY": "http://proxy.company.com:8080",
"HTTPS_PROXY": "http://proxy.company.com:8080",
"NO_PROXY": "localhost,127.0.0.1,.local,.internal"
}
}
}
}
Note: Mix and match environment variables as needed. All optional variables can be used independently or together.
npm install -g mcp-searxng
{
"mcpServers": {
"searxng": {
"command": "mcp-searxng",
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}
{
"mcpServers": {
"searxng": {
"command": "mcp-searxng",
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL",
"AUTH_USERNAME": "your_username",
"AUTH_PASSWORD": "your_password",
"USER_AGENT": "MyBot/1.0",
"HTTP_PROXY": "http://proxy.company.com:8080",
"HTTPS_PROXY": "http://proxy.company.com:8080",
"NO_PROXY": "localhost,127.0.0.1,.local,.internal"
}
}
}
}
docker pull isokoliuk/mcp-searxng:latest
{
"mcpServers": {
"searxng": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "SEARXNG_URL",
"isokoliuk/mcp-searxng:latest"
],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}
{
"mcpServers": {
"searxng": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "SEARXNG_URL",
"-e", "AUTH_USERNAME",
"-e", "AUTH_PASSWORD",
"-e", "USER_AGENT",
"-e", "HTTP_PROXY",
"-e", "HTTPS_PROXY",
"-e", "NO_PROXY",
"isokoliuk/mcp-searxng:latest"
],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL",
"AUTH_USERNAME": "your_username",
"AUTH_PASSWORD": "your_password",
"USER_AGENT": "MyBot/1.0",
"HTTP_PROXY": "http://proxy.company.com:8080",
"HTTPS_PROXY": "http://proxy.company.com:8080",
"NO_PROXY": "localhost,127.0.0.1,.local,.internal"
}
}
}
}
Note: Add only the -e flags and env variables you need.
docker build -t mcp-searxng:latest -f Dockerfile .
Use the same configuration as above, replacing isokoliuk/mcp-searxng:latest with mcp-searxng:latest.
Create a docker-compose.yml file:
services:
mcp-searxng:
image: isokoliuk/mcp-searxng:latest
stdin_open: true
environment:
- SEARXNG_URL=YOUR_SEARXNG_INSTANCE_URL
# Add any optional variables as needed:
# - AUTH_USERNAME=your_username
# - AUTH_PASSWORD=your_password
# - USER_AGENT=MyBot/1.0
# - HTTP_PROXY=http://proxy.company.com:8080
# - HTTPS_PROXY=http://proxy.company.com:8080
# - NO_PROXY=localhost,127.0.0.1,.local,.internal
Then configure your MCP client:
{
"mcpServers": {
"searxng": {
"command": "docker-compose",
"args": ["run", "--rm", "mcp-searxng"]
}
}
}
The server supports both STDIO (default) and HTTP transports. Set MCP_HTTP_PORT to enable HTTP mode.
{
"mcpServers": {
"searxng-http": {
"command": "mcp-searxng",
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL",
"MCP_HTTP_PORT": "3000"
}
}
}
}
HTTP Endpoints:
POST/GET/DELETE /mcpGET /healthTesting:
MCP_HTTP_PORT=3000 SEARXNG_URL=http://localhost:8080 mcp-searxng
curl http://localhost:3000/health
SEARXNG_URL=YOUR_URL OPENAI_API_KEY=your-key npx mcp-eval evals.ts src/index.ts
We welcome contributions! Follow these guidelines:
Coding Standards:
Workflow:
Fork and clone:
git clone https://github.com/YOUR_USERNAME/mcp-searxng.git
cd mcp-searxng
git remote add upstream https://github.com/ihor-sokoliuk/mcp-searxng.git
Setup:
npm install
npm run watch # Development mode with file watching
Development:
git checkout -b feature/your-feature-name
# Make changes in src/
npm run build
npm test
npm run test:coverage
npm run inspector
Submit:
git commit -m "feat: description"
git push origin feature/your-feature-name
# Create PR on GitHub
npm test # Run all tests
npm run test:coverage # Generate coverage report
npm run test:watch # Watch mode
Coverage: 100% success rate with comprehensive unit tests covering error handling, types, proxy configs, resources, and logging.
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
{ "mcpServers": { "eyzeci-mcp-searxng": { "command": "npx", "args": [ "-y", "@eyzeci/[email protected]" ] } }}Herramientas
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
Este registro no indica ninguna variable de entorno obligatoria.
@eyzeci/mcp Searxng se ejecuta localmente por stdio.
Última comprobación: 2026-11-16. MCP server for SearXNG integration