Power your agent
Cài đặt từ nhà phát hành. Không phải endpoint của PlugMCP.
Host a copy with our keys and logs.
Chưa có bản phát hành đóng gói nào trong registry. Làm theo README của kho mã.
URL từ xa hay một lệnh trên máy của bạn? Hai cách cài đặt khác nhau thế nào
Chạy trên 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.
MởTừ nhà phát hành
Self-hosted SearXNG metasearch with Redis caching, a Python query CLI, an MCP server for AI tools, and optional LLM-backed structured extraction. Clone, configure .env, run docker compose up -d, then search in the browser, from scripts, or through Cursor/Claude.
A preconfigured searxng docker instance and mcp server
.envcp env.example .env
# Edit .env: set SEARXNG_SECRET_KEY (see below) and OPENROUTER_API_KEY if using extract
openssl rand -hex 32 # paste into SEARXNG_SECRET_KEY
docker compose up -d
Minimum .env values:
SEARXNG_PROTOCOL=http
SEARXNG_HOST=localhost
SEARXNG_PORT=7777
SEARXNG_BASE_URL=${SEARXNG_PROTOCOL}://${SEARXNG_HOST}:${SEARXNG_PORT}/
SEARXNG_SECRET_KEY=<from openssl rand -hex 32>
SEARXNG_MCP_PORT=7778
For structured extraction, keep EXTRACT_ENABLED=true (default in env.example) and set:
OPENROUTER_API_KEY=sk-or-...
To disable the extract tool (search/fetch/crawl only), set EXTRACT_ENABLED=false in .env.
docker compose ps
curl -sf "http://localhost:7777/search?q=test&format=json" | head -c 200
curl -sf http://localhost:7778/health
SEARXNG_PORT)Pick the interface that fits your workflow. All paths use the same private SearXNG instance.
Open the search URL in a browser. No extra setup beyond Quick start.
Direct JSON search against SearXNG (no MCP):
curl "http://localhost:7777/search?q=python+docker&format=json"
curl "http://localhost:7777/search?q=docker&categories=general,it&format=json"
Response fields, engines, and error handling: API_DOCUMENTATION.md.
searxng_search.pyCommand-line wrapper around the SearXNG API (stdlib only):
python searxng_search.py "your search term"
python searxng_search.py "docker" --categories general,it
python searxng_search.py "python" --output json
More flags and examples: QUERY_SCRIPT_README.md.
The MCP server (searxng-mcp) exposes four capabilities. In agents, fetch returns full page text; extract fetches then returns JSON shaped by your schema and prompt—prefer extract on noisy pages when you want fields, not raw HTML.
REST examples (same host/port as health check):
# Search
curl -sS -X POST http://localhost:7778/search \
-H "Content-Type: application/json" \
-d '{"query": "python programming", "categories": "general,it"}'
# Fetch page text
curl -sS -X POST http://localhost:7778/fetch \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com"}'
# Crawl related pages
curl -sS -X POST http://localhost:7778/crawl \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com", "filters": ["documentation"], "subpage_limit": 5}'
# Extract structured JSON (EXTRACT_ENABLED=true, OPENROUTER_API_KEY set)
curl -sS -X POST http://localhost:7778/extract \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com","json_schema":{"type":"object","properties":{"title":{"type":"string"}},"required":["title"]}}'
extract_url.pyCLI for /extract without hand-writing JSON Schema:
python extract_url.py "https://example.com/article" --keys title,author,summary
python extract_url.py "https://example.com/article" \
--keys title,summary \
--prompt "Main article only; ignore navigation and related links"
python extract_url.py "https://example.com/article" \
--json '{"title":"Page title","summary":"Two-sentence summary"}'
Stdout is the extracted data object (indented JSON). Optional env: SEARXNG_MCP_HOST, SEARXNG_MCP_PORT (default localhost:7778), EXTRACT_TIMEOUT (default 120).
1. Point the client at the MCP server (~/.cursor/mcp.json or Claude Desktop config).
Streamable HTTP (recommended when the container port is reachable):
{
"mcpServers": {
"searxng": {
"url": "http://localhost:7778/mcp",
"description": "Private SearXNG: search, fetch, crawl, extract"
}
}
}
stdio via Docker exec (no published port required):
{
"mcpServers": {
"searxng": {
"command": "docker",
"args": ["exec", "-i", "searxng-mcp", "python", "server.py"],
"description": "Private SearXNG: search, fetch, crawl, extract"
}
}
}
Claude Desktop paths: macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json. Restart the app after editing.
2. Install the agent skill (Cursor, recommended) so the model knows when to use extract vs fetch and how to design schemas:
cp -r docs/searxng-skill ~/.cursor/skills/searxng-capabilities
Reload Cursor. Workflows: docs/searxng-skill/SKILL.md.
MCP implementation details: mcp-server/README.md. Extract pipeline: extractor-sidecar/README.md, docs/extract-sidecar-specification.md.
Services use restart: unless-stopped. Redis data lives in a Docker volume; SearXNG config in ./searxng/.
docker compose ps
docker compose logs --tail=50
docker compose pull && docker compose up -d # update images
Logs rotate at 1MB per container. Tune engines in searxng/settings.yml if needed.
Full reset (removes volumes):
docker compose down -v && docker compose up -d
Built on SearXNG, Docker, Redis, and the Model Context Protocol.
A preconfigured searxng docker instance and mcp server
Công cụ
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Sao chép cấu hình stdio cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Bản ghi này không liệt kê biến môi trường bắt buộc nào.
Searxng Docker chạy cục bộ qua stdio.
Kiểm tra lần cuối: 2026-10-28. A preconfigured searxng docker instance and mcp server
