SearXNG-MCP
SearXNG MCP Server
FastMCP를 기반으로 구현된 SearXNG 검색 MCP 서비스로, Streamable HTTP 전송을 사용하며 로컬 실행과 Docker 배포를 지원합니다.
SearXNG 관련 링크:
공식 문서: https://docs.searxng.org/
온라인 예시: https://searx.space/
기능
MCP 도구
search(query)노출: 키워드로 SearXNG 인스턴스를 호출하고 검색 결과 요약을 반환합니다.HTTP 엔드포인트
http://<host>:<port>/mcp를 통해 MCP 서비스를 제공하여 원격/크로스 도메인 호출을 지원합니다.무상태(stateless) Streamable HTTP 모드를 채택하여 클라이언트가
Mcp-Session-Id를 유지할 필요 없이 바로 동시 호출할 수 있습니다.환경 변수를 통한 SearXNG 인스턴스 주소 사용자 지정을 지원하여 프라이빗 배포에 용이합니다.
Related MCP server: web-search-mcp
환경 변수
변수명 | 기본값 | 설명 |
|
| SearXNG 인스턴스 루트 주소(JSON 활성화 필요) |
|
| 서비스 수신 주소 |
|
| 서비스 수신 포트 |
로컬 실행
# 安装依赖(建议使用虚拟环境)
pip install -r requirements.txt
# 可选:自定义 SearXNG 实例(只需填根地址)
export SEARXNG_URL="https://your-searxng-instance"
# 启动服务
python Server.py시작 후 MCP 엔드포인트는 다음과 같습니다:
http://localhost:9000/mcpDocker 배포
이미지 빌드
docker build -t searxng-mcp .컨테이너 실행
docker run -d \
--name searxng-mcp \
-p 9000:9000 \
-e SEARXNG_URL="https://searxng.abc.com" \
searxng-mcp포트를 변경하려면 컨테이너 내외부 포트와 PORT를 함께 덮어쓸 수 있습니다:
docker run -d \
--name searxng-mcp \
-p 8080:8080 \
-e PORT=8080 \
searxng-mcp온라인 이미지 사용
docker run -d \
--name searxng-mcp \
-p 9000:9000 \
-e SEARXNG_URL="https://searxng.abc.com" \
muzihuaner/searxng-mcp:latest접속 주소
배포 완료 후 MCP 엔드포인트 형식은 다음과 같습니다:
http://<你的服务器域名或IP>:<端口>/mcp예: http://localhost:9000/mcp 또는 https://mcp.your-domain.com/mcp
클라이언트 구성
Streamable HTTP를 지원하는 MCP 클라이언트에서 서비스 주소를 위의 /mcp 엔드포인트로 입력하면 됩니다. 예:
{
"mcpServers": {
"searxng": {
"url": "http://localhost:9000/mcp"
}
}
}도구 설명
search(query: str) -> str
키워드로 SearXNG 검색을 호출하고 각 결과 항목의 content 텍스트를 줄바꿈으로 연결하여 반환합니다.
query: 검색 키워드.반환: 검색 결과의 텍스트 내용; 요청 실패 시
False를 반환합니다.
동시성 및 성능
测试结果示例(局域网 / 上游 `so.xxx.cn`):
총 요청 수 : 100 동시 worker : 50 성공 : 100 실패 : 0 총 소요 시간(초) : 67.68 처리량(QPS) : 1.48 평균 지연(초) : 27.284 최소 지연(초) : 7.203 최대 지연(초) : 44.418
> 注意:端到端延迟主要取决于 SearXNG 上游实例的响应速度(本例平均约 27s 来自上游 `so.xxx.cn` 较慢),服务本身可稳定承载并发且零失败。若需提升吞吐,可:
> - 换用响应更快 / 自托管的 SearXNG 实例(通过 `SEARXNG_URL` 指定);자주 묻는 질문
Q: 클라이언트에서 Missing session ID 오류가 발생합니까?
A: 이 서비스는 stateless_http=True가 활성화되어 있어 세션이 필요 없습니다. 그래도 오류가 발생하면 클라이언트가 /mcp 엔드포인트를 가리키는지 확인하세요.
Q: 프로덕션 환경에서 CORS를 강화하려면 어떻게 하나요?
A: Server.py의 CORSMiddleware에서 allow_origins=["*"]를 특정 출처 목록(예: ["https://your-domain.com"])으로 변경하세요.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Unofficial Serper MCP — wraps the Serper Google Search API (serper.dev)
Web search and clean-text fetch MCP server (Tavily-powered, SSRF-guarded).
Unofficial Tavily MCP — wraps the Tavily API (tavily.com)
Live AI-native web search with citations. One tool for every MCP client. Flat per-request pricing.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables privacy-focused web search via SearXNG for MCP clients, allowing users to perform searches with customizable parameters through natural language.MIT
- FlicenseNot gradedqualityDmaintenanceProvides a free web search tool to MCP clients by connecting to a self-hosted SearXNG metasearch instance, enabling users to search the web with customizable parameters like categories and time range.-
- AlicenseAqualityBmaintenanceEnables MCP-compatible clients to perform web searches through a self-hosted SearXNG instance, with support for configurable languages, categories, time ranges, and safe search settings.2550 npmMIT
- FlicenseNot gradedqualityCmaintenanceEnables web search through one or two SearxNG instances and retrieval of web pages, GitHub READMEs, and article text via MCP tools.-