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"
      }
    }
  }
}