-
security-
license-
qualityA server that enables language models to perform web searches through SearXNG using the Model Context Protocol standard.
Last updated -
4
2
MIT License
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
Related MCP Servers
- Asecurity-licenseAqualityA Model Context Protocol server that enables AI assistants like Claude to perform real-time web searches using the Exa AI Search API in a safe and controlled manner.Last updated -610,191
- Asecurity-licenseAqualityA Model Context Protocol server that enables AI assistants to perform real-time web searches, retrieving up-to-date information from the internet via a Crawler API.Last updated -123517
- -security-license-qualityA Model Context Protocol server that provides real-time web search capabilities to AI assistants through pluggable search providers, currently integrated with the Brave Search API.Last updated -13MIT License