ihor-sokoliuk/mcp-searxng

Private web search for AI assistants via SearXNG — supports Claude, Cursor, and any MCP client

해결하는 문제

Claude 또는 Cursor와 같은 AI 어시스턴트는 종종 인터넷에 대한 실시간 액세스나 프라이빗 검색 엔진에 대한 액세스가 부족합니다. 이 프로젝트는 이러한 어시스턴트를 SearXNG 인스턴스에 연결하여 독점적 또는 유료 검색 API에 의존하지 않고도 웹 검색을 수행하고 웹사이트 콘텐츠를 읽을 수 있도록 하여 그 격차를 해소합니다.

작동 방식

이것은 Model Context Protocol (MCP) 서버로 작동하는 독립형 Node.js 프로세스입니다. HTTP JSON API를 통해 SearXNG 인스턴스(또는 여러 복제본)에 연결됩니다. AI 어시스턴트가 검색 또는 URL을 요청하면 이 서버가 SearXNG에 쿼리를 보내고, 페이지네이션을 처리하며, 여러 인스턴스 간의 장애 조치(failover)를 관리하고, 웹 페이지 콘텐츠를 어시스턴트가 읽을 수 있도록 Markdown으로 변환할 수도 있습니다.

대상 사용자

AI 개발자: 실시간 웹 데이터가 필요한 에이전트 워크플로우를 구축하는 개발자.
파워 유저: 어시스턴트에게 프라이빗, 셀프 호스팅 또는 무료 웹 검색 기능을 제공하고자 하는 MCP 호환 클라이언트(Claude Desktop 또는 Cursor 등) 사용자.
개인정보 보호 중시 사용자: 모든 검색 쿼리를 대형 상용 검색 엔진에 직접 보내는 것을 피하기 위해 SearXNG를 사용하고자 하는 사용자.

주요 특징

웹 검색 및 읽기: 일반, 뉴스 및 기사 쿼리를 지원하며, URL에 대해 콘텐츠 유형을 인식하는 Markdown 변환을 제공합니다.
고가용성: 자동 장애 조치 또는 결과 병합을 위한 병렬 팬아웃(fan-out) 기능을 갖춘 여러 SearXNG 복제본을 지원합니다.
지능형 캐싱: 검색 결과와 URL 콘텐츠 모두에 인메모리 캐싱을 사용하여 불필요한 네트워크 요청을 줄입니다.
견고성: JSON을 비활성화한 인스턴스를 위한 HTML 폴백, URL 읽기를 위한 SSRF 보호 및 프록시 지원을 포함합니다.