SerpApi MCP 서버

SerpApi와 통합하여 포괄적인 검색 엔진 결과 및 데이터 추출을 제공하는 MCP(Model Context Protocol) 서버 구현입니다.

기능

• 멀티 엔진 검색: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay 및 기타

• 엔진 리소스: MCP 리소스를 통해 엔진별 매개변수 스키마 제공 (검색 도구 참조)

• 실시간 날씨 데이터: 검색 쿼리를 통한 위치 기반 날씨 및 예보

• 주식 시장 데이터: 검색 통합을 통한 기업 재무 및 시장 데이터

• 동적 결과 처리: 다양한 결과 유형을 자동으로 감지하고 형식 지정

• 유연한 응답 모드: 전체 또는 간결한 JSON 응답

• JSON 응답: 전체 또는 간결한 모드를 갖춘 구조화된 JSON 출력

Related MCP server: SearXNG MCP Server

빠른 시작

SerpApi MCP 서버는 mcp.serpapi.com에서 호스팅 서비스로 제공됩니다. 연결하려면 API 키를 제공해야 합니다. API 키는 SerpApi 대시보드에서 찾을 수 있습니다.

Claude Desktop이 호스팅된 서버를 사용하도록 구성할 수 있습니다:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

자체 호스팅

git clone https://github.com/serpapi/serpapi-mcp.git
cd serpapi-mcp
uv sync && uv run src/server.py

Claude Desktop 구성:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "http://localhost:8000/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

API 키 가져오기: serpapi.com/manage-api-key

인증

두 가지 방법이 지원됩니다:

• 경로 기반: /YOUR_API_KEY/mcp (권장)

• 헤더 기반: Authorization: Bearer YOUR_API_KEY

예시:

# Path-based
curl "https://mcp.serpapi.com/your_key/mcp" -d '...'

# Header-based  
curl "https://mcp.serpapi.com/mcp" -H "Authorization: Bearer your_key" -d '...'

검색 도구

MCP 서버에는 모든 SerpApi 엔진과 결과 유형을 지원하는 하나의 주요 검색 도구가 있습니다. 사용 가능한 모든 매개변수는 SerpApi API 참조에서 확인할 수 있습니다. 엔진 매개변수 스키마는 serpapi://engines (인덱스) 및 serpapi://engines/<engine>와 같은 MCP 리소스로도 노출됩니다.

제공할 수 있는 매개변수는 각 API 엔진마다 다릅니다. 아래에 몇 가지 샘플 매개변수가 있습니다:

• params.q (필수): 검색 쿼리

• params.engine: 검색 엔진 (기본값: "google_light")

• params.location: 지리적 필터

• mode: 응답 모드 - "complete" (기본값) 또는 "compact"

• ...SerpApi API 참조에서 다른 매개변수 확인

예시:

{"name": "search", "arguments": {"params": {"q": "coffee shops", "location": "Austin, TX"}}}
{"name": "search", "arguments": {"params": {"q": "weather in London"}}}
{"name": "search", "arguments": {"params": {"q": "AAPL stock"}}}
{"name": "search", "arguments": {"params": {"q": "news"}, "mode": "compact"}}
{"name": "search", "arguments": {"params": {"q": "detailed search"}, "mode": "complete"}}

지원되는 엔진: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay 등 (serpapi://engines 참조).

결과 유형: 답변 상자, 유기적 결과, 뉴스, 이미지, 쇼핑 - 자동으로 감지되고 형식이 지정됩니다.

개발

# Local development
uv sync && uv run src/server.py

# Docker
docker build -t serpapi-mcp . && docker run -p 8000:8000 serpapi-mcp

# Regenerate engine resources (Playground scrape)
python build-engines.py

# Testing with MCP Inspector
npx @modelcontextprotocol/inspector
# Configure: URL mcp.serpapi.com/YOUR_KEY/mcp, Transport "Streamable HTTP transport"

문제 해결

• "Missing API key": URL 경로 /{YOUR_KEY}/mcp 또는 헤더 Bearer YOUR_KEY에 키를 포함하세요.

• "Invalid key": serpapi.com/dashboard에서 확인하세요.

• "Rate limit exceeded": 잠시 기다리거나 SerpApi 플랜을 업그레이드하세요.

• "No results": 다른 쿼리나 엔진을 시도해 보세요.

기여

1. 저장소를 포크하세요.

2. 기능 브랜치를 만드세요: git checkout -b feature/amazing-feature

3. 종속성을 설치하세요: uv install

4. 변경 사항을 적용하세요.

5. 변경 사항을 커밋하세요: git commit -m 'Add amazing feature'

6. 브랜치에 푸시하세요: git push origin feature/amazing-feature

7. Pull Request를 여세요.

라이선스

MIT 라이선스 - 자세한 내용은 LICENSE 파일을 참조하세요.