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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

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.

Tools

serper-google-search

Serper API를 사용하여 MCP 지원 애플리케이션에 Google 검색 기능을 통합하여 풍부한 검색 결과, 구성 가능한 매개변수, 효율적인 응답 처리를 제공합니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

serper-search-scrape-mcp-server
marcopesani
A
security
A
license
A
quality
This Serper MCP Server supports search and webpage scraping, and all the most recent parameters introduced by the Serper API, like location.
Last updated -
2
73
2
TypeScript
MIT License
Google Search MCP Server
mixelpixx
A
security
F
license
A
quality
An MCP (Model Context Protocol) server that provides Google search capabilities and webpage content analysis tools. This server enables AI models to perform Google searches and analyze webpage content programmatically.
Last updated -
3
39
52
TypeScript
MCP2Tavily
mcp2everything
A
security
F
license
A
quality
An MCP protocol server that enables web search functionality using the Tavily API, allowing AI assistants to perform internet searches in real-time.
Last updated -
4
2
Python
SerpApi MCP Server
ilyazub
-
security
F
license
-
quality
An MCP server that integrates with SerpApi to retrieve search results from multiple search engines including Google, Bing, Yahoo, and others, enabling fast access to both live and archived search data.
Last updated -
Python

View all related MCP servers

Serper Search MCP Server