README.md•4.88 kB
# SearXNG MCP Server
*Version: 0.0.2*
Perform privacy-respecting web searches using SearXNG through an MCP server!
This repository is actively maintained - Contributions are welcome!
### Supports:
- Privacy-respecting metasearch
- Customizable search parameters (language, time range, categories, engines)
- Safe search levels
- Pagination control
- Basic authentication support
- Random instance selection
<details>
<summary><b>Usage:</b></summary>
### CLI
| Short Flag | Long Flag | Description |
|------------|-------------|---------------------------------------------|
| -h | --help | See usage |
| -t | --transport | Transport method: 'stdio', 'http', or 'sse' (default: stdio) |
| -s | --host | Host address for HTTP transport (default: 0.0.0.0) |
| -p | --port | Port number for HTTP transport (default: 8000) |
### Using as an MCP Server:
AI Prompt:
```text
Search for information about artificial intelligence
```
AI Response:
```text
Search completed successfully. Found 10 results for "artificial intelligence":
1. **What is Artificial Intelligence?**
URL: https://example.com/ai
Content: Artificial intelligence (AI) refers to the simulation of human intelligence in machines...
2. **AI Overview**
URL: https://example.org/ai-overview
Content: AI encompasses machine learning, deep learning, and more...
```
</details>
<details>
<summary><b>Example:</b></summary>
### Use in CLI
```bash
searxng-mcp --transport http --host 0.0.0.0 --port 8000
```
### Use with AI
Deploy MCP Server as a Service
```bash
docker pull knucklessg1/searxng-mcp:latest
```
Modify the `compose.yml`
```yaml
services:
searxng-mcp:
image: knucklessg1/searxng-mcp:latest
environment:
- SEARXNG_URL=https://searxng.example.com
- SEARXNG_USERNAME=user
- SEARXNG_PASSWORD=pass
- USE_RANDOM_INSTANCE=false
- HOST=0.0.0.0
- PORT=8000
ports:
- 8000:8000
```
Configure `mcp.json`
```json
{
"mcpServers": {
"searxng": {
"command": "uv",
"args": [
"run",
"--with",
"searxng-mcp",
"searxng-mcp"
],
"env": {
"SEARXNG_URL": "https://searxng.example.com",
"SEARXNG_USERNAME": "user",
"SEARXNG_PASSWORD": "pass",
"USE_RANDOM_INSTANCE": "false"
},
"timeout": 300000
}
}
}
```
Run as a docker container:
```yaml
services:
searxng-mcp:
image: docker.io/knucklessg1/searxng-mcp:latest
ports:
- "8000:8000"
environment:
- HOST=0.0.0.0
- PORT=8000
- TRANSPORT=http
- SEARXNG_URL=https://searxng.example.com
- SEARXNG_USERNAME=user
- SEARXNG_PASSWORD=pass
- USE_RANDOM_INSTANCE=false
```
</details>
<details>
<summary><b>Installation Instructions:</b></summary>
Install Python Package
```bash
python -m pip install searxng-mcp
```
```bash
uv pip install searxng-mcp
```
</details>
<details>
<summary><b>Repository Owners:</b></summary>
<img width="100%" height="180em" src="https://github-readme-stats.vercel.app/api?username=Knucklessg1&show_icons=true&hide_border=true&&count_private=true&include_all_commits=true" />
</details>