Skip to main content
Glama
tisDDM

SearXNG MCP Server

SearXNG MCP 서버

AI 비서가 개인정보 보호 메타검색 엔진인 SearXNG를 사용하여 웹 검색을 수행할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. SearX.space 에서 무작위 인스턴스를 자동으로 선택하여 추가 배포 없이 바로 작동하며, 기본 인증을 사용하는 개인 인스턴스도 지원합니다.

특징

  • 제로 구성 설정 : SearX.space 의 임의의 공개 인스턴스를 사용하여 즉시 작동합니다.

  • 개인 인스턴스 지원 : 기본 인증 옵션을 사용하여 자신의 SearXNG 인스턴스에 연결합니다.

  • 사용자 정의 가능한 매개변수로 웹 검색 수행

  • 여러 검색 엔진 지원

  • 개인 정보 보호 중심 검색 결과

  • 마크다운 형식의 검색 결과

  • 모든 매개변수에 대한 합리적인 기본값

주의 - 이 목적을 위해 공용 인스턴스를 사용할 수 없고 "요청이 상태 코드 429로 실패했습니다"라는 메시지가 반환될 수 있습니다.

Related MCP server: Exa MCP Server

설치

필수 조건

  • Node.js(v16 이상)

  • npm(v7 이상)

  • SearXNG 인스턴스에 대한 액세스(자체 호스팅 또는 공개)

소스에서 설치

지엑스피1

구성

SearXNG MCP 서버는 다음 환경 변수로 구성할 수 있습니다.

  • SEARXNG_URL (선택 사항): SearXNG 인스턴스의 URL입니다(예: https://searx.example.com ). 이 값을 지정하지 않으면 SearX.space 에서 임의의 공개 인스턴스가 자동으로 선택되어 추가 배포 없이 서버를 사용할 수 있습니다.

  • USE_RANDOM_INSTANCE (선택 사항): URL이 제공되지 않을 때 무작위 인스턴스 선택을 비활성화하려면 "false"로 설정합니다. 기본값은 "true"입니다.

  • SEARXNG_USERNAME (선택 사항): 개인 인스턴스에 연결할 때 기본 인증을 위한 사용자 이름

  • SEARXNG_PASSWORD (선택 사항): 개인 인스턴스에 연결할 때 기본 인증을 위한 비밀번호

프로젝트의 루트 디렉토리에 있는 .env 파일에서 다음 환경 변수를 설정할 수 있습니다.

SEARXNG_URL=https://searx.example.com SEARXNG_USERNAME=your_username SEARXNG_PASSWORD=your_password

용법

서버 실행

# If installed globally searxngmcp # If installed from source node build/index.js

Claude Desktop과 통합

  1. 클로드 데스크톱 열기

  2. 설정 > MCP 서버로 이동하세요

  3. 다음 구성으로 새로운 MCP 서버를 추가합니다.

    { "mcpServers": { "searxngmcp": { "command": "searxngmcp", "env": { // Optional: If not provided, a random public instance will be used "SEARXNG_URL": "https://searx.example.com", // Optional: Only needed for private instances with authentication "SEARXNG_USERNAME": "your_username", "SEARXNG_PASSWORD": "your_password" }, "disabled": false, "autoApprove": [] } } }

VSCode에서 Claude와 통합하기

  1. VSCode 열기

  2. 설정 > 확장 프로그램 > Claude > MCP 설정으로 이동하세요.

  3. 다음 구성으로 새로운 MCP 서버를 추가합니다.

    { "mcpServers": { "searxngmcp": { "command": "node", "args": ["/path/to/searxng-mcp/build/index.js"], "env": { // Optional: If not provided, a random public instance will be used "SEARXNG_URL": "https://searx.example.com", // Optional: Only needed for private instances with authentication "SEARXNG_USERNAME": "your_username", "SEARXNG_PASSWORD": "your_password" }, "disabled": false, "autoApprove": [] } } }

스몰렌제트와 함께 사용

SearXNG MCP는 AI 에이전트 구축을 위한 경량 프레임워크인 Smolagents와 쉽게 통합할 수 있습니다. 이를 통해 웹 검색 및 결과 처리를 지원하는 강력한 리서치 에이전트를 만들 수 있습니다.

from smolagents import CodeAgent, LiteLLMModel, ToolCollection from mcp import StdioServerParameters # Configure the SearXNG MCP server server_parameters = StdioServerParameters( command="node", args=["path/to/searxng-mcp/build/index.js"], env={ "SEARXNG_URL": "https://your-searxng-instance.com", "SEARXNG_USERNAME": "your_username", # Optional "SEARXNG_PASSWORD": "your_password" # Optional } ) # Create a tool collection from the MCP server with ToolCollection.from_mcp(server_parameters) as tool_collection: # Initialize your LLM model model = LiteLLMModel( model_id="your-model-id", api_key="your-api-key", temperature=0.7 ) # Create an agent with the search tools search_agent = CodeAgent( name="search_agent", tools=tool_collection.tools, model=model ) # Run the agent with a search prompt result = search_agent.run( "Perform a search about: 'climate change solutions' and summarize the top 5 results." ) print(result)

사용 가능한 도구

검색

개인정보를 보호하는 메타검색 엔진인 SearXNG를 사용하여 웹 검색을 수행하세요. 사용자 정의 가능한 매개변수를 사용하여 관련성 높은 웹 콘텐츠를 제공합니다.

매개변수

매개변수

유형

설명

기본

필수의

질문

검색어

-

언어

검색 결과에 대한 언어 코드(예: 'en', 'de', 'fr')

'en'

아니요

시간 범위

검색 결과의 기간입니다. 옵션: '일', '주', '월', '년'

아니요

카테고리

문자열 배열

검색할 카테고리(예: '일반', '이미지', '뉴스')

아니요

엔진

문자열 배열

사용할 특정 검색 엔진

아니요

안전 검색

숫자

안전 검색 수준: 0(해제), 1(보통), 2(엄격)

1

아니요

페이지노

숫자

결과 페이지 번호입니다. 최소 1페이지 이상이어야 합니다.

1

아니요

최대 결과

숫자

반환할 최대 검색 결과 수입니다. 범위: 1~50

10

아니요

// Example request const result = await client.callTool('searxngsearch', { query: 'climate change solutions', language: 'en', time_range: 'year', categories: ['general', 'news'], safesearch: 1, max_results: 5 });

개발

설정

# Clone the repository git clone https://github.com/tisDDM/searxng-mcp.git cd searxng-mcp # Install dependencies npm install

짓다

npm run build

시청 모드(개발용)

npm run watch

MCP Inspector로 테스트

npm run inspector

특허

MIT

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tisDDM/searxng-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server