Skip to main content
Glama
enesjakozh

Google Search MCP Server

by Claw256
npmGitHub
TypeScript
MIT License
11
5
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

웹 검색 MCP 서버

Google 검색 기능과 고급 봇 감지 회피 기능을 갖춘 웹 콘텐츠 보기 기능을 제공하는 MCP 서버입니다.

특징

  • 고급 필터링이 포함된 Google 맞춤 검색

  • 마크다운 변환을 통한 웹 콘텐츠 보기

  • 속도 제한 및 캐싱

  • 브라우저 인스턴스 풀링

  • Rebrowser-puppeteer를 이용한 봇 탐지 회피

필수 조건

  • Bun 런타임 v1.0 이상

  • Google API 자격 증명(API 키 및 검색 엔진 ID)

설치

지엑스피1

구성

쿠키 설정

인증된 사이트에 접속하려면 다음이 필요합니다.

  1. Get cookies.txt LOCALLY Chrome 확장 프로그램을 설치하세요

  2. 인증을 원하는 사이트를 방문하여 로그인하세요.

  3. 확장 프로그램을 사용하여 쿠키를 JSON 형식으로 내보내세요

  4. 내보낸 쿠키 파일을 안전한 위치에 저장하세요

  5. BROWSER_COOKIES_PATH 환경 변수를 쿠키 파일의 절대 경로로 설정합니다.

MCP 서버 구성

MCP 설정 파일에 서버 구성을 추가합니다.

  • Cline의 경우: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json

  • Claude Desktop의 경우:

    • MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "web-search": { "command": "bun", "args": [ "run", "/ABSOLUTE/PATH/TO/web_search_mcp/dist/index.js" ], "env": { "GOOGLE_API_KEY": "your_api_key", "GOOGLE_SEARCH_ENGINE_ID": "your_search_engine_id", "MAX_CONCURRENT_BROWSERS": "3", "BROWSER_TIMEOUT": "30000", "RATE_LIMIT_WINDOW": "60000", "RATE_LIMIT_MAX_REQUESTS": "60", "SEARCH_CACHE_TTL": "3600", "VIEW_URL_CACHE_TTL": "7200", "MAX_CACHE_ITEMS": "1000", "BROWSER_POOL_MIN": "1", "BROWSER_POOL_MAX": "5", "BROWSER_POOL_IDLE_TIMEOUT": "30000", "REBROWSER_PATCHES_RUNTIME_FIX_MODE": "addBinding", "REBROWSER_PATCHES_SOURCE_URL": "jquery.min.js", "REBROWSER_PATCHES_UTILITY_WORLD_NAME": "util", "REBROWSER_PATCHES_DEBUG": "0", "BROWSER_COOKIES_PATH": "C:\\path\\to\\cookies.json", "LOG_LEVEL": "info", "NO_COLOR": "0", "BUN_FORCE_COLOR": "1", "FORCE_COLOR": "1" } } } }

/ABSOLUTE/PATH/TO/web_search_mcp 서버 디렉토리의 절대 경로로 바꾸세요.

로깅 구성

다음 환경 변수는 로깅 동작을 제어합니다.

  • LOG_LEVEL : 로깅 수준(error, warn, info, debug)을 설정합니다. 기본값: info

  • NO_COLOR : "1"로 설정하면 컬러 출력을 비활성화합니다.

  • BUN_FORCE_COLOR : Bun 런타임에서 컬러 출력을 제어합니다(비활성화하려면 "0"으로 설정)

  • FORCE_COLOR : 전역적으로 컬러 출력을 제어합니다(비활성화하려면 "0"으로 설정)

봇 감지 회피

이 서버는 봇 감지를 피하기 위해 rebrowser-puppeteer를 사용합니다.

  1. 런타임.누수 방지 활성화:

    • Runtime.Enable 감지를 방지하기 위해 addBinding 기술을 사용합니다.

    • 웹 워커 및 iframe과 함께 작동합니다.

    • 주요 세계 컨텍스트에 대한 액세스를 유지합니다.

  2. 소스 URL 마스킹:

    • Puppeteer의 sourceURL을 합법적인 스크립트처럼 보이도록 변경합니다.

    • 자동화 도구 감지를 방지하는 데 도움이 됩니다.

  3. 유틸리티 세계 이름:

    • 일반 유틸리티 세계 이름을 사용합니다.

    • 세계 이름 패턴을 통한 감지 방지

  4. 브라우저 실행 구성:

    • 자동화 플래그를 비활성화합니다

    • 최적화된 Chrome 인수를 사용합니다.

    • 뷰포트 및 창 설정을 구성합니다.

Claude Desktop과 함께 사용

  1. Claude Desktop이 설치되어 있고 최신 버전으로 업데이트되었는지 확인하세요.

  2. Claude Desktop 구성 파일을 엽니다.

    • MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  3. 위의 구성 섹션에 표시된 대로 서버 구성을 추가합니다.

  4. Claude Desktop을 다시 시작하세요

  5. 망치 아이콘을 찾으세요 도구를 사용할 수 있는지 확인하려면

사용 가능한 도구

1. 검색 도구

{ name: "search", params: { query: string; trustedDomains?: string[]; excludedDomains?: string[]; resultCount?: number; safeSearch?: boolean; dateRestrict?: string; } }

2. URL 보기 도구

{ name: "view_url", params: { url: string; includeImages?: boolean; includeVideos?: boolean; preserveLinks?: boolean; formatCode?: boolean; } }

문제 해결

Claude Desktop 통합 문제

  1. 로그를 확인하세요:

    # MacOS/Linux tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\Logs\mcp*.log

  2. 일반적인 문제:

    • 서버가 표시되지 않음: 구성 파일 구문 및 경로를 확인하세요.

    • 도구 호출 실패: 서버 로그를 확인하고 Claude Desktop을 다시 시작하세요.

    • 경로 문제: 절대 경로를 사용하고 있는지 확인하세요.

더 자세한 문제 해결 방법은 MCP 디버깅 가이드를 참조하세요.

개발

# Run in development mode with watch bun --watch run dev # Run tests bun run test # Run linter bun run lint

중요 참고 사항

  1. 봇 감지:

    • 봇 감지 회피 기능은 가장 일반적인 감지 방법을 방지하는 데 도움이 됩니다.

    • 그러나 적절한 프록시 및 사용자 에이전트와 같은 추가 조치가 필요할 수 있습니다.

    • 일부 웹사이트는 여전히 다른 수단을 통해 자동화를 감지할 수 있습니다.

  2. 성능:

    • 브라우저 인스턴스는 풀링되어 재사용됩니다.

    • 유휴 브라우저는 자동으로 정리됩니다.

    • 리소스 제한으로 과부하 방지

특허

MIT

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

MCP 프로토콜을 통해 고급 봇 감지 회피 기능과 함께 Google 검색 기능, 웹 콘텐츠 추출 및 스크린샷 기능을 제공합니다.

  1. 특징
    1. 필수 조건
      1. 설치
        1. 구성
          1. 쿠키 설정
          2. MCP 서버 구성
          3. 로깅 구성
        2. 봇 감지 회피
          1. Claude Desktop과 함께 사용
            1. 사용 가능한 도구
              1. 1. 검색 도구
              2. 2. URL 보기 도구
            2. 문제 해결
              1. Claude Desktop 통합 문제
            3. 개발
              1. 중요 참고 사항
                1. 특허

                  Related Resources

                  Related MCP Servers

                  • 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 -
                    11
                    139

                  • SEO AI Assistant

                    ccnn2509
                    -
                    security
                    F
                    license
                    -
                    quality
                    Provides SEO automation with tools for keyword research, SERP analysis, and competitor analysis through Google Ads API integration, enabling AI assistants to access these capabilities via MCP.
                    Last updated -
                    27

                  • G-Search MCP

                    jae-jae
                    A
                    security
                    A
                    license
                    A
                    quality
                    A powerful MCP server that enables parallel Google searching with multiple keywords simultaneously, providing structured results while handling CAPTCHAs and simulating user browsing patterns.
                    Last updated -
                    1
                    217
                    204
                    MIT License
                    • Apple

                  • Google Search MCP Server

                    Fabien-desablens
                    A
                    security
                    F
                    license
                    A
                    quality
                    An MCP server that provides Google Search functionality with automatic API key rotation and intelligent quota management, enabling natural language search queries with advanced filtering options.
                    Last updated -
                    1
                    11
                    1
                    • Linux
                    • Apple

                  View all related MCP servers

                  Appeared in Searches

                  New MCP Servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/Claw256/mcp-web-search'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server