Web Search MCP Server 518aa0df

MCP搜索检索

提供方 slinusc

搜索检索 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

一个生产就绪的模型上下文协议(MCP)服务器,通过SearXNG提供网页搜索功能,专为与LLM代理无缝集成而设计,支持HTTP/SSE传输和LLM优化的响应格式。

一句话选型结论

按资料字段整理

Web Search MCP Server 518aa0df 属于搜索检索类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 5 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

多引擎搜索Python本地部署LLM优化知识提取实时流式传输Docker支持

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python -m venv venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Web Search MCP Server 518aa0df当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方slinusc上游标注的维护方 slinusc
分类搜索检索本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.6 KB
来自项目仓库与上游目录的原文,未做删改

Web Search MCP Server

A production-ready Model Context Protocol (MCP) server that provides web search capabilities through SearXNG. Designed for seamless integration with LLM agents, featuring HTTP/SSE transport and LLM-optimized response formatting.

Features

  • Multi-Engine Search - Aggregates results from Brave, DuckDuckGo, Startpage, and more
  • LLM-Optimized - Three specialized tools with formatted responses for agent consumption
  • Knowledge Extraction - Automatic extraction of structured facts from Wikidata
  • Real-Time Streaming - MCP over HTTP/SSE for live agent integration
  • Docker Ready - Fully containerized with docker-compose
  • Production Features - Health checks, metrics, structured logging, request tracking

Architecture```

┌─────────────────────┐
│ LLM Agent │
│ (MCP Client) │
└──────────┬──────────┘
│ MCP over HTTP/SSE
↓
┌─────────────────────┐
│ Web Search MCP │ Port 8003
│ Server │
│ - 3 Search Tools │
│ - REST API │
│ - Metrics │
└──────────┬──────────┘
│ HTTP
↓
┌─────────────────────┐
│ SearXNG │ Port 8888
│ (Meta-Search) │
│ - Brave │
│ - DuckDuckGo │
│ - Startpage │
│ - Wikipedia │
└─────────────────────┘


## Quick Start

### Prerequisites

- Docker & Docker Compose
- (Optional) Python 3.11+ for local development

### 1. Clone and Start```bash
git clone https://github.com/slinusc/web-search-mcp-server.git
cd web-search-mcp-server
docker compose up -d

This starts:
- SearXNG on port 8888 (search backend)
- MCP Server on port 8003 (agent interface)

2. Test the API```bash

Quick search (LLM-optimized)

curl -X POST http://localhost:8003/api/quick_search \
-H "Content-Type: application/json" \
-d '{"query": "latest developments in AI"}'

Structured search (with facts)

curl -X POST http://localhost:8003/api/structured_search \
-H "Content-Type: application/json" \
-d '{"query": "climate change 2024"}'

Health check

curl http://localhost:8003/healthz


### 3. Connect Your MCP Client```json
{
  "mcpServers": {
    "websearch": {
      "url": "http://localhost:8003/sse"
    }
  }
}

MCP Tools

1. web_search

Comprehensive search with full metadata```python
{
"query": "machine learning frameworks",
"categories": "general", # or "news", "images", "videos"
"pageno": 1
}


Returns: Full SearXNG response with all engines, suggestions, and infoboxes.

### 2. `quick_search`
**Fast, LLM-optimized results**```python
{
  "query": "who invented the internet",
  "categories": "general"
}

Returns: Top 10 ranked results with knowledge base, relevance scores, and source attribution.

3. structured_search

Facts-focused with context```python
{
"query": "Python programming language",
"categories": "general"
}


Returns: Ranked results + Wikidata attributes + context snippets + suggestions.

## Response Format

### Quick Search Example```json
{
  "ok": true,
  "request_id": "a1b2c3d4e5f6",
  "query": "Python programming",
  "total_results": 28,
  "knowledge_base": {
    "entity": "Python (programming language)",
    "description": "Python is a high-level, interpreted programming language...",
    "attributes": {
      "Developer": "Python Software Foundation",
      "First appeared": "1991",
      "Influenced by": "ABC, Modula-3, C"
    },
    "image": "https://upload.wikimedia.org/..."
  },
  "top_results": [
    {
      "rank": 1,
      "title": "Python.org",
      "url": "https://www.python.org/",
      "snippet": "Python is a programming language that lets you work quickly...",
      "score": 9.0,
      "engines": ["brave", "duckduckgo", "startpage"]
    }
  ],
  "engines_used": ["brave", "duckduckgo", "startpage", "wikipedia"]
}

REST API Reference

Endpoint Method Description
/sse GET MCP SSE stream (for agents)
/messages POST MCP client messages
/api/search POST General web search
/api/quick_search POST Quick LLM-optimized search
/api/structured_search POST Structured facts search
/healthz GET Health check
/metrics GET Performance metrics
/tools GET List available MCP tools

Configuration

Environment Variables```bash

docker-compose.yml or .env

SEARXNG_URL=http://searxng:8080 # SearXNG backend URL
SEARXNG_TIMEOUT=10.0 # Request timeout (seconds)


### SearXNG Configuration

Edit `config/settings.yml` to:
- Enable/disable search engines
- Configure result formats
- Set rate limiting
- Customize search behavior

Key settings:```yaml
search:
  formats:
    - html
    - json  # Required for MCP server

server:
  limiter: false  # Adjust for production

Development

Local Setup```bash

Create virtual environment

python -m venv venv
source venv/bin/activate # or venv\Scripts\activate on Windows

Install dependencies

pip install -r requirements.txt

Run server

python server.py


Server runs on `http://localhost:8003`

### Testing```bash
# Test quick search
curl -X POST http://localhost:8003/api/quick_search \
  -H "Content-Type: application/json" \
  -d '{"query": "test query"}'

# Check metrics
curl http://localhost:8003/metrics

# List available tools
curl http://localhost:8003/tools | jq

Docker

Build```bash

docker build -t mcp-server-websearch .


### Run Standalone```bash
docker run -d \
  --name mcp-websearch \
  -p 8003:8003 \
  -e SEARXNG_URL=http://searxng:8080 \
  mcp-server-websearch

Compose (Recommended)```bash

Start all services

docker compose up -d

View logs

docker compose logs -f mcp-websearch

Stop services

docker compose down


## Monitoring

### Health Check```bash
curl http://localhost:8003/healthz
# Response: ok

Metrics```bash

curl http://localhost:8003/metrics


Response:```json
{
  "ok": true,
  "metrics": {
    "api_search_calls": 42,
    "api_quick_search_calls": 156,
    "api_structured_search_calls": 23,
    "mcp_call_tool_calls": 221,
    "searxng_requests": 221,
    "errors_total": 2
  }
}

Agent Integration

Generic MCP Client

The server exposes three MCP tools that are automatically available to any MCP-compatible agent:

  • web_search - For comprehensive search with full details
  • quick_search - For fast answers with top results
  • structured_search - For research with structured facts

LangChain Integration```python

from langchain.tools import Tool

Wrap the MCP tools

tools = [
Tool(
name="web_search",
func=call_mcp_tool, # Your MCP client wrapper
description="Search the web for current information"
)
]


## Use Cases

- **Question Answering** - Quick answers with source attribution
- **Research Assistants** - Deep research with structured facts
- **RAG Systems** - Retrieve current information for context
- **News Monitoring** - Track recent events and developments
- **Fact Checking** - Verify information across multiple sources

## Security Notes

- **Rate Limiting**: Configure SearXNG's `limiter.toml` for production
- **API Keys**: Not required (SearXNG is self-hosted)
- **CORS**: Currently allows all origins - restrict in production
- **Network**: Use Docker networks to isolate services

## Troubleshooting

### SearXNG returns 403 Forbidden```bash
# Check if JSON format is enabled in config/settings.yml
docker exec searxng grep -A 3 "formats:" /etc/searxng/settings.yml

# Should show:
# formats:
#   - html
#   - json

Connection refused errors```bash

Ensure services are running

docker compose ps

Check logs

docker compose logs searxng
docker compose logs mcp-websearch


### No search results```bash
# Test SearXNG directly
curl -X POST http://localhost:8888/search \
  -H "X-Forwarded-For: 127.0.0.1" \
  --data "q=test&format=json"

License

MIT License - see LICENSE file for details.

Acknowledgments

  • SearXNG - Privacy-respecting metasearch engine
  • Model Context Protocol - Anthropic's MCP specification
  • Starlette - Lightweight ASGI framework

Contributing

Contributions welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Open a Pull Request

Support

  • Issues: GitHub Issues
  • Discussions: GitHub Discussions

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Web Search MCP Server 518aa0df 怎么安装?

在客户端按下面的安装命令接入:python -m venv venv。装完在客户端配置里引用同一个包或端点。

Web Search MCP Server 518aa0df 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Web Search MCP Server 518aa0df 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Web Search MCP Server 518aa0df 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Web Search MCP Server 518aa0df 能提供哪些能力?

资料显示能力标签包括 Python、Docker支持、搜索。具体工具清单以官方文档为准。

Web Search MCP Server 518aa0df 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Web Search MCP Server 518aa0df 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。