SearXNG MCP 서버

개요

SearXNG MCP 서버는 가볍고 오픈 소스인 모델 컨텍스트 프로토콜(MCP) 서버로서, AI 어시스턴트(Claude, Cursor, LM Studio, 로컬 LLM 등)와 SearXNG — 널리 사용되는 자기 호스팅, 프라이버시를 존중하는 메타검색 엔진 — 사이를 연결합니다.

이를 통해 에이전트는 Google이나 Bing 같은 상용 API에 의존하지 않고 웹 검색을 수행할 수 있어, 쿼리가 추적, 프로파일링 또는 페이월로부터 자유롭고 비공개로 유지됩니다. 여러 커뮤니티 구현이 존재하며, 가장 인기 있는 것은 ihor-sokoliuk가 적극적으로 유지 관리하는 Node.js 버전입니다.

주요 기능

• 프라이버시 중심 검색: 사용자 추적 없이 수십 개의 검색 엔진(Google, Bing, DuckDuckGo 등)에서 결과를 집계합니다.
• 구성 가능한 SearXNG 인스턴스: JSON API를 통해 공개 또는 자기 호스팅된 SearXNG 인스턴스와 작동합니다.
• 페이지네이션 지원: 포괄적인 연구를 위해 결과의 추가 페이지를 가져옵니다. -B 안전 검색 제어**: 구성 가능한 수준으로 노골적인 콘텐츠를 필터링합니다. -The 구조화된 결과**: LLM 사용에 최적화된 깔끔하게 파싱된 결과를 반환합니다. -B 쉬운 배포**: npx, Docker 또는 로컬에서 Node.js/Python/Go 변형을 사용하여 실행합니다. -The 다중 클라이언트 호환성**: Claude Desktop, Cursor, Windsurf 및 기타 MCP 호환 도구와 원활하게 작동합니다.

사용 사례

• 근거 있는 연구: Claude가 오래된 학습 데이터에 의존하는 대신 정확한 답변을 위해 최신 정보를 가져오도록 합니다. -L 로컬/비공개 AI 워크플로우**: Ollama 또는 LM Studio와 결합하여 완전히 오프라인 가능한(검색 제외) 에이전트 구성을 만듭니다. -The 코딩 지원**: 개발 중 실시간으로 문서, 라이브러리 또는 오류 메시지를 검색합니다. -B 뉴스 및 최신 사건**: 광고나 스폰서 콘텐츠 없이 최신 기사와 요약을 얻습니다. -The 다중 도구 오케스트레이션**: 강력한 자율 에이전트를 위해 다른 MCP 서버(브라우저, 데이터베이스, 코드 실행)와 페어링합니다.

작동 방식

1. MCP 서버를 실행합니다(로컬 프로세스 또는 Docker 컨테이너).
2. MCP 클라이언트(예: Claude Desktop)를 구성하여 연결합니다.
3. AI가 자동으로 searxng_web_search 도구를 발견합니다.
4. 에이전트가 최신 웹 데이터가 필요할 때, MCP 프로토콜을 통해 도구를 호출합니다.
5. 서버가 선택한 SearXNG 인스턴스에 쿼리하고 구조화된 결과를 반환합니다.

빠른 설치 및 설정 (가장 많이 사용하는 Node.js 버전)

npx 사용하기 (가장 쉬운 방법):

Claude Desktop 설정(claude_desktop_config.json)에 다음을 추가하세요:

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": {
        "SEARXNG_URL": "https://your-searxng-instance.example.com"
      }
    }
  }
}

최대한의 개인정보 보호를 위해 자체 호스팅된 SearXNG 사용 권장 (공식 SearXNG 리포지토리에서 Docker로 실행).

Docker 옵션:

docker pull mcpcommunity/ihor-sokoliuk-mcp-searxng:latest

다른 주목할 만한 구현체:

• Python/uv 변형 (예: The-AI-Workshops)
• 고성능을 위한 Go 버전
• 스크래핑 또는 카테고리 지원이 포함된 향상된 포크 버전

설정 옵션

• SEARXNG_URL: SearXNG 인스턴스 URL (공개 또는 비공개).
• 여러 포크 버전에서 프록시 및 인증 지원.
• 안전 검색 수준 및 결과 카테고리 (일반, 뉴스, 이미지 등).

MCP 클라이언트에 서버를 추가한 후 재시작하세요. 도구가 에이전트의 사용 가능한 도구에 자동으로 나타날 것입니다.

일반적인 팁

• 최상의 개인정보 보호 및 안정성을 위해 자체 호스팅된 SearXNG 인스턴스를 사용하세요.
• 공개 인스턴스는 빠른 테스트에 사용할 수 있지만 속도 제한 또는 다운타임이 있을 수 있습니다.
• 더 깊은 연구를 위해 페이지 가져오기 도구와 결합하세요 (많은 포크 버전이 콘텐츠 추출 기능을 포함하고 있습니다).

SearXNG MCP는 MCP 생태계에서 가장 널리 사용되는 개인정보 보호 중심 웹 검색 도구 중 하나로, 로컬-퍼스트 또는 개인정보 보호 중심 AI 에이전트를 구축하거나 사용하는 모든 사람에게 필수적입니다.

최신 버전과 전체 문서는 주요 리포지토리를 방문하세요.