SearXNG MCP 서버

SearXNG와 통합되어 개인정보 보호에 중점을 둔 메타 검색 기능을 제공하는 MCP 서버 구현입니다.

특징

메타 검색 : 여러 검색 엔진의 결과를 결합합니다.
개인정보 보호 중심 : 추적 없음, 사용자 프로파일링 없음
다양한 카테고리 : 일반, 뉴스, 과학, 파일, 이미지, 비디오 등 지원
언어 지원 : 특정 언어 또는 모든 언어로 검색
시간 범위 필터링 : 일, 주, 월 또는 연도별로 결과를 필터링합니다.
안전 검색 : 3단계 안전 검색 필터링
폴백 지원 : 안정성을 위한 여러 SearXNG 인스턴스

Related MCP server: MCP Google Server

설치

지엑스피1

용법

직접 실행

mcp-server-searxng

다이브 데스크톱 포함

Dive Desktop에서 "+ MCP 서버 추가"를 클릭하세요.
다음 구성을 복사하여 붙여넣으세요.

{ "mcpServers": { "searxng": { "command": "npx", "args": [ "-y", "@kevinwatt/mcp-server-searxng" ] } } }

"저장"을 클릭하여 MCP 서버를 설치하세요.

도구 문서

웹 검색
- 여러 엔진에서 메타 검색을 실행합니다.
- 입력:
  - query (문자열): 검색어
  - page (번호, 선택 사항): 페이지 번호(기본값: 1)
  - language (문자열, 선택 사항): 언어 코드(예: 'en', 'all', 기본값: 'all')
  - categories (배열, 선택 사항): 카테고리 검색(기본값: ['general'])
    - 사용 가능: "일반", "뉴스", "과학", "파일", "이미지", "비디오", "음악", "소셜 미디어", "IT"
  - time_range (문자열, 선택 사항): 시간 필터(일/주/월/년)
  - safesearch (숫자, 선택 사항): 안전 검색 수준(0: 없음, 1: 보통, 2: 엄격, 기본값: 1)

개발

git clone https://github.com/kevinwatt/mcp-server-searxng.git cd mcp-server-searxng npm install npm run build npm start

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

필수 조건

로컬 SearXNG 인스턴스가 실행 중이어야 합니다. 설정하려면 다음을 따르세요.

Docker로 SearXNG 실행

빠른 시작

# Create config directory mkdir -p searxng # Create config file tee searxng/settings.yml << EOF use_default_settings: true server: bind_address: "0.0.0.0" secret_key: "CHANGE_THIS_TO_SOMETHING_SECURE" # Generate a random key port: 8080 search: safe_search: 0 formats: - html - json engines: - name: google engine: google shortcut: g - name: duckduckgo engine: duckduckgo shortcut: d - name: bing engine: bing shortcut: b server.limiter: false EOF # Start container docker run -d \ --name searxng \ -p 8080:8080 \ -v "$(pwd)/searxng:/etc/searxng" \ searxng/searxng

테스트 검색 기능

# Test JSON API with curl curl -v 'http://localhost:8080/search?q=test&format=json' # Or visit in browser http://localhost:8080/search?q=test

컨테이너 관리

# Stop container docker stop searxng # Remove container docker rm searxng # View container logs docker logs searxng # Enable auto-start on boot docker update --restart always searxng

--restart always 플래그는 다음을 보장합니다.

Docker 데몬이 시작되면 컨테이너가 자동으로 시작됩니다.
컨테이너가 충돌하면 자동으로 다시 시작됩니다.
사용자가 명시적으로 중지하지 않는 한 컨테이너는 중지되면 자동으로 다시 시작됩니다.

사용자 정의 구성

searxng/settings.yml 다음과 같이 편집합니다.

검색 엔진 목록 수정
보안 설정 조정
UI 언어 구성
API 제한 변경

자세한 구성 옵션은 SearXNG 문서를 참조하세요.

환경 변수

SEARXNG_INSTANCES : SearXNG 인스턴스 URL의 쉼표로 구분된 목록 기본값: http://localhost:8080
SEARXNG_USER_AGENT : 요청에 대한 사용자 정의 사용자 에이전트 헤더 기본값: MCP-SearXNG/1.0
NODE_TLS_REJECT_UNAUTHORIZED : SSL 인증서 검증을 우회하려면 '0'으로 설정합니다(자체 서명 인증서를 사용하는 개발의 경우). 기본값: 정의되지 않음(SSL 검증 활성화)

모든 옵션이 포함된 구성 예:

{ "mcpServers": { "searxng": { "name": "searxng", "command": "npx", "args": [ "-y", "@kevinwatt/mcp-server-searxng" ], "env": { "SEARXNG_INSTANCES": "http://localhost:8080,https://searx.example.com", "SEARXNG_USER_AGENT": "CustomBot/1.0", "NODE_TLS_REJECT_UNAUTHORIZED": "0" } } } }