> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Search MCP Integrationsanleitung

> serp MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) ist ein von Anthropic eingeführtes Modellkontextprotokoll, das es KI-Modellen (wie Claude, GPT usw.) ermöglicht, externe Tools über standardisierte Schnittstellen aufzurufen. Über den von XHuoAPI bereitgestellten SERP MCP Server kannst du direkt in AI-Clients wie Claude Desktop, VS Code, Cursor usw. Google-Suchen durchführen und Ergebnisse wie Webseiten, Bilder, Nachrichten, Videos, Orte usw. abrufen.

## Funktionsübersicht

Der SERP MCP Server bietet folgende Kernfunktionen:

* **Websuche** — Suche nach Google-Webergebnissen
* **Bildersuche** — Suche nach Google-Bildern
* **Nachrichtensuche** — Suche nach Google-Nachrichten
* **Videosuche** — Suche nach Google-Videos
* **Ortsuche** — Suche nach Google-Ortsinformationen
* **Kartensuche** — Suche nach Google-Karten
* **Mehrsprachigkeit und Regionen** — Unterstützung für benutzerdefinierte Länder- und Sprachparameter
* **Zeitraumfilterung** — Ergebnisse nach Tag, Woche, Monat, Jahr filtern

## Vorbereitungen

Vor der Nutzung musst du ein XHuoAPI API-Token erhalten:

1. Registriere dich oder melde dich bei der [XHuoAPI Plattform](https://api.xhuoapi.ai) an
2. Gehe zur [Google SERP API](https://api.xhuoapi.ai/documents/serp-google) Seite
3. Klicke auf „Acquire“, um ein API-Token zu erhalten (bei der ersten Anfrage gibt es ein kostenloses Kontingent)

## Installation und Konfiguration

### Methode 1: pip-Installation (empfohlen)

```bash theme={null}
pip install mcp-serp
```

### Methode 2: Quellcode-Installation

```bash theme={null}
git clone https://github.com/XHuoAPI/SerpMCP.git
cd SerpMCP
pip install -e .
```

Nach der Installation kannst du den Dienst mit dem Befehl `mcp-serp` starten.

## Verwendung in Claude Desktop

Bearbeite die Konfigurationsdatei von Claude Desktop:

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

Füge die folgende Konfiguration hinzu:

```json theme={null}
{
  "mcpServers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "dein API-Token"
      }
    }
  }
}
```

Wenn du `uvx` verwendest (keine vorherige Installation erforderlich):

```json theme={null}
{
  "mcpServers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "dein API-Token"
      }
    }
  }
}
```

Speichere die Konfiguration und starte Claude Desktop neu, um Google-Suchwerkzeuge im Dialog zu verwenden.

## Verwendung in VS Code / Cursor

Erstelle im Stammverzeichnis des Projekts die Datei `.vscode/mcp.json`:

```json theme={null}
{
  "servers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "dein API-Token"
      }
    }
  }
}
```

Oder verwende `uvx`:

```json theme={null}
{
  "servers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "dein API-Token"
      }
    }
  }
}
```

## Verfügbare Werkzeugliste

| Werkzeugname         | Beschreibung            |
| -------------------- | ----------------------- |
| `serp_google_search` | Google-Websuche         |
| `serp_google_images` | Google-Bildersuche      |
| `serp_google_news`   | Google-Nachrichtensuche |
| `serp_google_videos` | Google-Videosuche       |
| `serp_google_places` | Google-Ortsuche         |
| `serp_google_maps`   | Google-Kartensuche      |

## Nutzung Beispiele

Nach der Konfiguration kannst du diese Funktionen direkt in den AI-Clients mit natürlicher Sprache aufrufen, zum Beispiel:

* „Hilf mir, die neuesten AI-Papiere zu suchen“
* „Suche nach guten Hotpot-Restaurants in Peking“
* „Finde Bilder über Python asynchrone Programmierung“
* „Suche nach den heutigen Technologieneuigkeiten“
* „Finde in der Karte nahegelegene Cafés“

## Weitere Informationen

* GitHub-Repository: [XHuoAPI/SerpMCP](https://github.com/XHuoAPI/SerpMCP)
* PyPI-Paket: [mcp-serp](https://pypi.org/project/mcp-serp/)
* API-Dokumentation: [Suchmaschinen-API](https://api.xhuoapi.ai/documents/serp)