SearXNG MCP Server
An MCP server implementation that integrates the SearXNG API, providing web search capabilities.
接入你的智能体
发布者自己的命令。不是 PlugMCP 端点。
用我们的密钥与日志托管一份副本。
npx -y @eyzeci/[email protected]Claude Code 没有针对本地命令的安装链接。复制下方命令并在终端中运行。
claude mcp add eyzeci-mcp-searxng -- npx -y @eyzeci/mcp-searxng@0.9.1在终端中运行。
{ "mcpServers": { "eyzeci-mcp-searxng": { "command": "npx", "args": [ "-y", "@eyzeci/[email protected]" ] } }}claude_desktop_config.json
远程 URL 还是本机命令? 两种安装方式的区别
来自发布者
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]" ] } }}工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
@eyzeci/mcp Searxng 通过 stdio 在本地运行。
上次检查时间:2026-11-16。 MCP server for SearXNG integration