MCP SearXNG Go
A high-performance Model Context Protocol (MCP) server implementation in Go that provides AI assistants with privacy-focused web search capabilities through SearXNG.
Built with the maintained in collaboration with Google.
Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน 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.
เปิดจากผู้เผยแพร่
A high-performance Model Context Protocol (MCP) server implementation in Go that provides AI assistants with privacy-focused web search capabilities through SearXNG.
Built with the maintained in collaboration with Google.
Go MCP server for Claude Desktop offering SearXNG web search and URL-to-Markdown reader. Includes Docker/local runs, 60s cache, 10MB limit, 30s timeout, and security hardening.
Clone the repository:
git clone https://github.com/Tomlord1122/mcp-searxng-claude-go.git
cd mcp-searxng-claude-go
Create environment file:
cp .env.example .env
echo "SEARXNG_SECRET=$(openssl rand -hex 16)" >> .env
Start services:
# Build and start both SearXNG and MCP server
docker compose up -d
# Or use convenience script
./start-mcp.sh
Verify it's running:
docker compose logs -f mcp-searxng-go
Setup your environment to use it in Claude Code
Create a file with this name ~/.mcp.json
{
"mcpServers": {
"searxng": {
"command": "docker",
"args": ["exec", "-i", "mcp-searxng-go", "/app/mcp-searxng-go"],
"env": {
"SEARXNG_URL": "http://searxng:8080"
}
}
}
}
Add this to ~/.claude/settings.json
{
"permissions": {
"allow": [
"mcp__searxng__web_search",
"mcp__searxng__url_read"
]
},
"enabledMcpjsonServers": [
"searxng"
]
}
Install dependencies:
make deps
Build the binary:
make build
Run locally:
# Requires a running SearXNG instance
SEARXNG_URL=http://localhost:8080 ./mcp-searxng-go
web_searchPerforms web searches using SearXNG.
Parameters:
query (required): Search query stringpageno (optional): Page number (default: 1)time_range (optional): Filter by time - "day", "month", or "year"language (optional): Language code (e.g., "en", "fr", "de", default: "all")safesearch (optional): Safe search level - "0", "1", or "2" (default: "0")Example:
{
"query": "Go programming best practices",
"pageno": 1,
"language": "en"
}
url_readReads and converts web page content to Markdown.
Parameters:
url (required): URL to fetchstartChar (optional): Starting character positionmaxLength (optional): Maximum characters to returnsection (optional): Extract specific heading sectionparagraphRange (optional): Paragraph range (e.g., "1-5", "10-")readHeadings (optional): Return only headings (boolean)Example:
{
"url": "https://example.com/article",
"maxLength": 5000
}
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"searxng": {
"command": "docker",
"args": ["exec", "-i", "mcp-searxng-go", "/app/mcp-searxng-go"],
"env": {
"SEARXNG_URL": "http://searxng:8080"
}
}
}
}
Or if installed locally:
{
"mcpServers": {
"searxng": {
"command": "/usr/local/bin/mcp-searxng-go",
"env": {
"SEARXNG_URL": "http://localhost:8080"
}
}
}
}
The SearXNG instance is automatically configured to output JSON format. Custom search engines can be configured in searxng/config/settings.yml.
By default this repo ships with a curated set of ~14 enabled engines (google, bing, duckduckgo, brave, startpage, wikipedia, wikidata, github, stackoverflow, askubuntu, superuser, arxiv, pypi, mdn) instead of SearXNG's full default set, to reduce memory/CPU/connection overhead and avoid several upstream-broken engines that otherwise spam startup logs with errors. All other engines remain present but disabled — flip disabled: true off for any engine you want to re-enable.
Outgoing request behavior is also tuned down to match this smaller engine set: request_timeout: 3.0 / max_request_timeout: 8.0, pool_connections: 20, pool_maxsize: 10 (down from the defaults of 100/20, sized for the original ~82-engine set).
Both the searxng and searxng-go services set an explicit Docker logging driver (json-file, max-size: 10m, max-file: 3) in docker-compose.yml, so container logs rotate and are capped at ~30MB per service regardless of the host Docker daemon's own defaults.
make help # Show all available commands
make deps # Download Go dependencies
make build # Build the binary
make run # Run locally (requires SEARXNG_URL)
make test # Run tests
make docker-up # Start Docker containers
make docker-down # Stop Docker containers
make docker-logs # View Docker logs
make install # Install to /usr/local/bin
make build-all # Build for multiple platforms
┌─────────────────────────┐
│ AI Assistant (Claude) │
└───────────┬─────────────┘
│ MCP Protocol (stdio)
│
┌───────────▼─────────────┐
│ MCP Server (Go) │
│ ┌──────────────────┐ │
│ │ Search Client │───┼──► SearXNG (Docker)
│ │ URL Reader │───┼──► Internet
│ │ Cache (60s TTL) │ │
│ └──────────────────┘ │
└─────────────────────────┘
mcp-searxng-claude-go/
├── main.go # Application entry point
├── searxng.go # SearXNG API client
├── urlreader.go # URL fetching and HTML-to-Markdown conversion
├── cache.go # In-memory caching with TTL
├── proxy.go # HTTP proxy configuration
├── resources.go # MCP resources (config, help)
├── Dockerfile # Multi-stage Docker build
├── docker-compose.yml # Service orchestration
├── Makefile # Build automation
└── .env.example # Environment template
Go MCP server for Claude Desktop offering SearXNG web search and URL-to-Markdown reader. Includes Docker/local runs, 60s cache, 10MB limit, 30s timeout, and security hardening.
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
MCP Searxng Claude Go ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-28 Go MCP server for Claude Desktop offering SearXNG web search and URL-to-Markdown reader. Includes Docker/local runs, 60s cache, 10MB limit, 30s timeout, and security hardening.