Serper Search MCP 서버

Serper API를 통해 Google 검색 기능을 제공하는 모델 컨텍스트 프로토콜(MPP) 서버와 AI 기반 심층 연구 도구가 함께 제공됩니다. 이 서버를 사용하면 MCP 지원 애플리케이션에 검색 및 연구 기능을 쉽게 통합할 수 있습니다.

✨ 특징

🌐 Serper API를 통한 강력한 Google 검색 통합
🔄 다음을 포함한 풍부한 검색 응답 데이터:
- 지식 그래프 정보
- 유기적 검색 결과
- "사람들이 묻는 또 다른 질문"
- 관련 검색
🧠 AI 기반 심층 연구 도구:
- 여러 단계의 반복적 연구를 수행합니다.
- 주제를 철저히 탐색하기 위해 하위 쿼리를 생성합니다.
- 다양한 출처의 정보를 종합합니다
- 모든 정보에 대한 인용을 제공합니다
- 조정 가능한 연구 깊이 수준
- 지속적인 개선을 위한 내장된 품질 측정 항목
🛠 구성 가능한 검색 매개변수:
- 국가 타겟팅
- 언어 선택
- 결과 개수 사용자 정의
- 자동 수정 옵션
🔒 안전한 API 키 처리
⚡️ 속도 제한 및 캐싱 지원
📝 전체 유형 정의를 통한 TypeScript 지원
📊 결과 최적화를 위한 통합 성과 지표

🚀 설치

저장소를 복제합니다.

지엑스피1

종속성 설치:

pnpm install

서버를 빌드하세요:

pnpm run build

⚙️ 구성

[Serper.dev]( https://serper.de 에서 Serper API 키를 받으세요.
루트 디렉토리에 .env 파일을 만듭니다.

# Required
SERPER_API_KEY=your_api_key_here

# Optional - Advanced Quality Metrics Configuration (pre-configured by default)
USAGE_METRICS_KEY=your-custom-metrics-key     # Optional
USAGE_PROJECT_ID=your-custom-project-id       # Optional
METRICS_ENDPOINT=https://your-custom-host.com # Optional
DISABLE_METRICS=false                         # Not recommended

자세한 내용은 TELEMETRY.md를 참조하세요.

품질 지표 수집
성능 모니터링
사용 분석
대시보드 설정
지속적인 개선

🔌 통합

클로드 데스크탑

Claude Desktop 구성에 서버 구성을 추가합니다.

MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "serper-search-server": {
      "command": "/path/to/serper-search-server/build/index.js",
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

🛠 사용법

검색 도구

서버는 다음과 같은 매개변수를 사용하여 강력한 검색 도구를 제공합니다.

{
  "query": string,          // Search query
  "numResults"?: number,    // Number of results (default: 10, max: 100)
  "gl"?: string,           // Country code (e.g., "us", "uk")
  "hl"?: string,           // Language code (e.g., "en", "es")
  "autocorrect"?: boolean, // Enable autocorrect (default: true)
  "type"?: "search"        // Search type (more types coming soon)
}

심층 연구 도구

더욱 포괄적인 연구 요구 사항을 위해 서버는 다음 매개변수를 사용하여 다단계 연구를 수행하는 심층 연구 도구를 제공합니다.

{
  "query": string,          // Research query or question
  "depth"?: "basic" | "standard" | "deep",  // Research depth (default: "standard")
  "maxSources"?: number     // Maximum sources to include (default: 10)
}

심층 연구 도구:

복잡한 쿼리를 집중된 하위 쿼리로 분해합니다.
포괄적인 정보를 수집하기 위해 여러 검색을 실행합니다.
AI를 사용하여 여러 소스의 정보를 합성합니다.
적절한 인용 및 참조를 사용하여 결과를 형식화합니다.
중간 결과를 기반으로 연구 전략을 조정합니다.
검색 결과를 개선하기 위해 익명의 품질 측정 항목을 수집합니다.

심도 수준:

기본: 빠른 개요(3-5개 소스, ~5분) 적합한 대상: 간단한 사실, 빠른 정의, 간단한 질문
표준: 종합 분석(5-10개 소스, ~10분) 적합 대상: 대부분의 연구 요구 사항, 균형 잡힌 깊이와 속도
심층적: 포괄적인 연구(10개 이상의 출처, ~15-20분) 복잡한 주제, 학술 연구, 철저한 분석에 적합

검색 도구 예시 응답

검색 결과에는 다음과 같은 풍부한 데이터가 포함되어 있습니다.

{
  "searchParameters": {
    "q": "apple inc",
    "gl": "us",
    "hl": "en",
    "autocorrect": true,
    "type": "search"
  },
  "knowledgeGraph": {
    "title": "Apple",
    "type": "Technology company",
    "website": "http://www.apple.com/",
    "description": "Apple Inc. is an American multinational technology company...",
    "attributes": {
      "Headquarters": "Cupertino, CA",
      "CEO": "Tim Cook (Aug 24, 2011–)",
      "Founded": "April 1, 1976, Los Altos, CA"
    }
  },
  "organic": [
    {
      "title": "Apple",
      "link": "https://www.apple.com/",
      "snippet": "Discover the innovative world of Apple...",
      "position": 1
    }
  ],
  "peopleAlsoAsk": [
    {
      "question": "What does Apple Inc mean?",
      "snippet": "Apple Inc., formerly Apple Computer, Inc....",
      "link": "https://www.britannica.com/topic/Apple-Inc"
    }
  ],
  "relatedSearches": [
    {
      "query": "Who invented the iPhone"
    }
  ]
}

🔍 응답 유형

지식 그래프

가능한 경우 엔터티 정보를 포함합니다.

제목 및 유형
웹사이트 URL
설명
주요 속성

유기적 결과

다음을 포함한 검색 결과 목록:

제목 및 URL
스니펫(설명)
결과에서의 위치
사용 가능한 경우 사이트 링크

사람들도 묻습니다

검색과 관련된 일반적인 질문:

질문 텍스트
답변 조각
소스 링크

📊 품질 지표

Deep Research 도구에는 통합된 품질 측정 항목이 포함되어 있습니다.

연구 프로세스 지표
성능 모니터링
이슈 추적
사용 패턴
결과 품질 지표

검색 품질을 개선하기 위해 수집된 지표에 대한 자세한 내용은 TELEMETRY.md를 참조하세요.

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

📝 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

🙏 감사의 말

Google 검색 기능을 제공하기 위한 Serper API
MCP 프레임워크를 위한 모델 컨텍스트 프로토콜
분석 기능을 위한 PostHog

Serper Search MCP Server

Integrations