Przewodnik po integracji Google Search MCP

MCP (Model Context Protocol) to protokół kontekstu modelu wprowadzony przez Anthropic, który pozwala modelom AI (takim jak Claude, GPT itp.) na wywoływanie zewnętrznych narzędzi za pomocą znormalizowanego interfejsu. Dzięki SERP MCP Server dostarczonemu przez AceData Cloud, możesz bezpośrednio przeprowadzać wyszukiwania w Google w klientach AI, takich jak Claude Desktop, VS Code, Cursor, uzyskując wyniki wyszukiwania stron internetowych, obrazów, wiadomości, filmów, miejsc itp.

Przegląd funkcji

SERP MCP Server oferuje następujące kluczowe funkcje:

wyszukiwanie stron internetowych — wyszukiwanie wyników stron Google
wyszukiwanie obrazów — wyszukiwanie obrazów Google
wyszukiwanie wiadomości — wyszukiwanie wiadomości Google
wyszukiwanie filmów — wyszukiwanie filmów Google
wyszukiwanie miejsc — wyszukiwanie informacji o miejscach Google
wyszukiwanie map — wyszukiwanie map Google
wielojęzyczność i wiele regionów — wsparcie dla niestandardowych parametrów kraju i języka
filtrowanie według zakresu czasowego — filtrowanie wyników według dni, tygodni, miesięcy, lat

Przygotowanie wstępne

Przed użyciem musisz uzyskać token API AceData Cloud:

Zarejestruj się lub zaloguj na platformie AceData Cloud
Przejdź do strony Google SERP API
Kliknij „Acquire”, aby uzyskać token API (pierwsze zgłoszenie daje darmowy limit)

Instalacja i konfiguracja

Metoda 1: instalacja pip (zalecana)

pip install mcp-serp

Metoda 2: instalacja ze źródła

git clone https://github.com/AceDataCloud/SerpMCP.git
cd SerpMCP
pip install -e .

Po zakończeniu instalacji możesz użyć polecenia mcp-serp, aby uruchomić serwis.

Użycie w Claude Desktop

Edytuj plik konfiguracyjny Claude Desktop:

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

Dodaj następującą konfigurację:

{
  "mcpServers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Twój token API"
      }
    }
  }
}

Jeśli używasz uvx (nie wymaga wcześniejszej instalacji pakietu):

{
  "mcpServers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Twój token API"
      }
    }
  }
}

Po zapisaniu konfiguracji uruchom ponownie Claude Desktop, aby móc korzystać z narzędzi wyszukiwania Google w rozmowie.

Użycie w VS Code / Cursor

Utwórz plik .vscode/mcp.json w katalogu głównym projektu:

{
  "servers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Twój token API"
      }
    }
  }
}

Lub użyj uvx:

{
  "servers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Twój token API"
      }
    }
  }
}

Lista dostępnych narzędzi

Nazwa narzędzia	Opis
`serp_google_search`	Wyszukiwanie stron Google
`serp_google_images`	Wyszukiwanie obrazów Google
`serp_google_news`	Wyszukiwanie wiadomości Google
`serp_google_videos`	Wyszukiwanie filmów Google
`serp_google_places`	Wyszukiwanie miejsc Google
`serp_google_maps`	Wyszukiwanie map Google

Przykłady użycia

Po skonfigurowaniu możesz bezpośrednio wywoływać te funkcje w kliencie AI za pomocą naturalnego języka, na przykład:

„Pomóż mi wyszukać najnowsze prace naukowe o AI”
„Wyszukaj dobre restauracje z hot pot w Pekinie”
„Znajdź obrazy dotyczące programowania asynchronicznego w Pythonie”
„Wyszukaj dzisiejsze wiadomości technologiczne”
„Znajdź pobliskie kawiarnie na mapie”

Więcej informacji

Repozytorium GitHub: AceDataCloud/SerpMCP
Pakiet PyPI: mcp-serp
Dokumentacja API: API wyszukiwarek

​Przegląd funkcji

​Przygotowanie wstępne

​Instalacja i konfiguracja

​Metoda 1: instalacja pip (zalecana)

​Metoda 2: instalacja ze źródła

​Użycie w Claude Desktop

​Użycie w VS Code / Cursor

​Lista dostępnych narzędzi

​Przykłady użycia

​Więcej informacji