remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Supports configuration via .env files for setting SearXNG URL and optional authentication credentials
Provides search results in Markdown format for better readability and structure
Enables running as a Node.js-based MCP server that can be integrated with VSCode and other environments

SearXNG MCP 서버

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

특징

제로 구성 설정 : SearX.space 의 임의의 공개 인스턴스를 사용하여 즉시 작동합니다.
개인 인스턴스 지원 : 기본 인증 옵션을 사용하여 자신의 SearXNG 인스턴스에 연결합니다.
사용자 정의 가능한 매개변수로 웹 검색 수행
여러 검색 엔진 지원
개인 정보 보호 중심 검색 결과
마크다운 형식의 검색 결과
모든 매개변수에 대한 합리적인 기본값

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

설치

필수 조건

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과 통합

클로드 데스크톱 열기
설정 > MCP 서버로 이동하세요
다음 구성으로 새로운 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와 통합하기

VSCode 열기
설정 > 확장 프로그램 > Claude > MCP 설정으로 이동하세요.
다음 구성으로 새로운 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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

SearXNG(개인 정보를 존중하는 메타검색 엔진)를 사용하여 AI 도우미가 웹 검색을 수행할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.

SearXNG MCP Server