https://github.com/secretiveshell/mcp-searxng
MCP server for connecting agentic systems to search systems via searXNG
https://github.com/secretiveshell/mcp-searxng
Last synced: about 2 months ago
JSON representation
MCP server for connecting agentic systems to search systems via searXNG
- Host: GitHub
- URL: https://github.com/secretiveshell/mcp-searxng
- Owner: SecretiveShell
- License: mit
- Created: 2024-12-13T15:54:33.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2025-02-21T17:12:52.000Z (4 months ago)
- Last Synced: 2025-05-04T23:40:30.116Z (about 2 months ago)
- Language: Python
- Size: 37.1 KB
- Stars: 63
- Watchers: 1
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# MCP-searxng
An MCP server for connecting agentic systems to search systems via [searXNG](https://docs.searxng.org/).
## Tools
Search the web with SearXNG
## Prompts
```python
search(query: str) -> f"Searching for {query} using searXNG"
```
## Usage
### via uvx
1) configure your client JSON like
```json
{
"mcpServers": {
"searxng": {
"command": "uvx",
"args": [
"mcp-searxng"
]
}
}
}
```
### via git clone
1) Add the server to claude desktop (the entrypoint is main.py)
Clone the repo and add this JSON to claude desktop
you can run this server with `uvx mcp-searxng`, or use a local copy of the repo
```json
{
"mcpServers": {
"searxng": {
"command": "uv",
"args": [
"--project",
"/absoloute/path/to/MCP-searxng/",
"run",
"/absoloute/path/to/MCP-searxng/mcp-searxng/main.py"
]
}
}
}
```
you will need to change the paths to match your environment
### Custom SearXNG URL
2) set the environment variable `SEARXNG_URL` to the URL of the searxng server (default is `http://localhost:8080`)
3) run your MCP client and you should be able to search the web with searxng
Note: if you are using claude desktop make sure to kill the process (task manager or equivalent) before running the server again