hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Included as one of the search engines that SearXNG queries for results, configured with the shortcut 'd'.
Included as one of the search engines that SearXNG queries for results, configured with the shortcut 'g'.
Integrates with SearXNG to provide privacy-focused meta search capabilities, combining results from multiple search engines with features like language support, time range filtering, and safe search.

SearXNG MCP 서버

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

특징

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

설치

지엑스피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"
      }
    }
  }
}

⚠️ 경고: 프로덕션 환경에서는 SSL 인증서 검증을 비활성화하는 것이 권장되지 않습니다.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

web_search

이 서버는 추적이나 사용자 프로파일링 없이 여러 검색 엔진을 통합하여 개인 정보 보호에 중점을 둔 메타 검색 기능을 제공하고, 필터링된 검색에 대해 다양한 카테고리와 언어를 지원합니다.

Related Resources

Reddit Discussion about this server

SearXNG MCP Server