SearXNG MCP 서버
SearXNG와 통합되어 개인정보 보호에 중점을 둔 메타 검색 기능을 제공하는 MCP 서버 구현입니다.
특징
- 메타 검색 : 여러 검색 엔진의 결과를 결합합니다.
- 개인정보 보호 중심 : 추적 없음, 사용자 프로파일링 없음
- 다양한 카테고리 : 일반, 뉴스, 과학, 파일, 이미지, 비디오 등 지원
- 언어 지원 : 특정 언어 또는 모든 언어로 검색
- 시간 범위 필터링 : 일, 주, 월 또는 연도별로 결과를 필터링합니다.
- 안전 검색 : 3단계 안전 검색 필터링
- 폴백 지원 : 안정성을 위한 여러 SearXNG 인스턴스
설치
지엑스피1
용법
직접 실행
- 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:8080SEARXNG_USER_AGENT : 요청에 대한 사용자 정의 사용자 에이전트 헤더 기본값: MCP-SearXNG/1.0NODE_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 인증서 검증을 비활성화하는 것이 권장되지 않습니다.