Serpex MCP

Serpex API를 통해 다중 엔진 웹 검색 기능을 제공하는 Model Context Protocol(MCP) 서버입니다. 자동 엔진 라우팅과 구조화된 JSON 결과로 Google, Bing, DuckDuckGo, Brave, Yahoo, Yandex에서 검색할 수 있습니다.

기능

✅ 다중 엔진 지원: 6개 검색 엔진(Google, Bing, DuckDuckGo, Brave, Yahoo, Yandex) 지원
✅ 자동 라우팅: 사용 가능한 최상의 검색 엔진을 자동 선택
✅ 시간 필터링: 일, 주, 월, 연도별로 결과 필터링
✅ 구조화된 결과: 깔끔하고 일관된 JSON 응답
✅ 빠르고 안정적: 내장된 캡차 처리 및 프록시 순환
✅ 간편한 통합: Claude Desktop, Jan AI 및 모든 MCP 호환 클라이언트에서 동작

Related MCP server: Serper Search and Scrape MCP Server

설치

빠른 시작 (npx - 권장)

설치가 필요 없습니다! npx로 직접 실행하세요:

npx serpex-mcp

전역 설치

npm install -g serpex-mcp

로컬 설치

npm install serpex-mcp

사용 방법

Claude Desktop에서 사용

macOS의 경우 Claude Desktop 구성 파일(~/Library/Application Support/Claude/claude_desktop_config.json)에 추가하세요:

{
  "mcpServers": {
    "serpex": {
      "command": "npx",
      "args": ["-y", "serpex-mcp"],
      "env": {
        "SERPEX_API_KEY": "your-api-key-here"
      }
    }
  }
}

다른 MCP 클라이언트에서 사용

MCP 호환 클라이언트라면 모두 이 서버를 사용할 수 있습니다. 다음과 같이 구성하세요:

• 명령어: npx

• 인자: -y serpex-mcp

• 환경 변수: SERPEX_API_KEY=your-key

독립 실행

export SERPEX_API_KEY="your-api-key-here"
serpex-mcp

사용 가능한 도구

serpex_search

Serpex 다중 엔진 API를 사용하여 웹을 검색합니다. 선택적으로 상위 결과에 대해 전체 페이지 콘텐츠(markdown)를 검색 결과와 함께 가져옵니다. 최선 노력(best-effort) 방식이므로 각 결과에서 content와 content_error를 확인하세요.

매개변수:

• q (필수): 검색 쿼리 문자열 (최대 500자)

• include_content (선택, boolean): 상위 결과에 대해 전체 페이지 콘텐츠(markdown)도 함께 가져옵니다. 최선 노력 방식으로, 결과 URL의 약 79%가 콘텐츠를 반환하며 차단되거나 robots가 금지한 페이지는 대신 content_error를 반환합니다. 기본값: false.

• content_results (선택, 5 | 10): include_content가 true일 때 콘텐츠를 가져올 상위 결과 수입니다. 정확히 5 또는 10이어야 합니다. 기본값: 5.

예시:

{
  "q": "artificial intelligence trends 2025",
  "include_content": true,
  "content_results": 5
}

응답(JSON, 도구 출력 텍스트)에는 content_requested / content_delivered 개수가 포함되며, 각 결과에는 성공 시 content, 실패 시 content_error가 포함됩니다. 콘텐츠가 요청되지 않은 경우 두 키 모두 생략됩니다.

API 키 받기

1. serpex.dev를 방문하세요.

2. 무료 계정에 가입하세요.

3. 대시보드에서 API 키를 받으세요.

4. SERPEX_API_KEY 환경 변수에 이 키를 사용하세요.

API 정보

• 기본 URL: https://api.serpex.dev

• 문서: https://serpex.dev/docs

• 요금제: 무료 티어 이용 가능, 합리적인 유료 플랜

개발

소스에서 빌드

git clone https://github.com/divyeshradadiya/serpex-mcp.git
cd serpex-mcp
pnpm install
pnpm build

테스트 실행

export SERPEX_API_KEY="your-key-here"
pnpm test

라이선스

MIT

링크

• Serpex 웹사이트

• Serpex 문서

• Model Context Protocol

• MCP 명세