Gemini MCP Server

Ein universeller MCP-Server, der mit der Google Gemini API Textgenerierung und Bildgenerierung (Imagen) ermöglicht.

Generierte Bilder werden als lokaler absoluter Pfad zurückgegeben (die Bilddaten selbst sind nicht im Ergebnis des Tool-Aufrufs enthalten). Die gespeicherten Dateien werden an ftp_upload_file von ftp-mcp übergeben, um sie in eine öffentliche URL umzuwandeln, und über wp_upload_media_from_url von wp-mcp in der WordPress-Mediathek registriert – der Server ist als erste Stufe dieses zweistufigen Flows gedacht. Das Ergebnis der Textgenerierung wird direkt als Ergebnis des Tool-Aufrufs zurückgegeben.

1. Einrichtung

cd gemini-mcp
npm install

Kopieren Sie config.json.example in config.json und tragen Sie den API-Schlüssel ein, den Sie in Google AI Studio (https://aistudio.google.com/apikey) ausgestellt haben (Diese Datei enthält den API-Schlüssel – veröffentlichen, teilen oder committen Sie sie auf keinen Fall in Git. Sie ist in .gitignore enthalten).

cp config.json.example config.json

{
  "api_key": "AIza................................",
  "default_text_model": "gemini-2.5-flash",
  "default_image_model": "imagen-4.0-generate-001"
}

• api_key: Der in Google AI Studio ausgestellte API-Schlüssel.

• default_text_model: Die Modell-ID, die verwendet wird, wenn der Parameter model von generate_text weggelassen wird.

• default_image_model: Die Modell-ID, die verwendet wird, wenn der Parameter model von generate_image weggelassen wird.

Die Modellpalette wird in der offiziellen Google-Dokumentation regelmäßig aktualisiert. Die aktuellsten Modell-IDs finden Sie unter https://ai.google.dev/gemini-api/docs/models (Text) / https://ai.google.dev/gemini-api/docs/imagen (Bild).

Der Server selbst kann auch gestartet werden, wenn kein API-Schlüssel gesetzt ist (der Platzhalter bleibt erhalten). Erst wenn generate_text / generate_image tatsächlich aufgerufen werden, tritt ein Authentifizierungsfehler auf Seiten von Google auf.

Related MCP server: MCP Nano Banana

2. Registrierung in Claude Code

Fügen Sie im Stammordner des Projekts, in dem Sie Claude Code verwenden, die Informationen des MCP-Servers zu .mcp.json hinzu.

{
  "mcpServers": {
    "gemini": {
      "command": "node",
      "args": ["/MCPの保存パス/gemini-mcp/index.js"],
      "env": {
        "GEMINI_MCP_CONFIG_PATH": "/MCPの保存パス/gemini-mcp/config.json"
      }
    }
  }
}

Starten Sie nach der Registrierung die Claude-Code-Sitzung neu, damit der MCP-Server neu geladen wird.

3. Bereitgestellte Tools

• gemini_check_config — Prüft, ob ein API-Schlüssel gesetzt ist, und zeigt die Standardmodellnamen an (ruft keine API auf).

• generate_text — Generiert Text für einen Prompt und gibt ihn direkt zurück.

  • prompt (erforderlich): Der Eingabe-Prompt.

  • system_instruction (optional): Eine Systemanweisung, die das Verhalten des gesamten Modells festlegt.

  • temperature (optional, 0–2): Die Zufälligkeit der Ausgabe.

  • model (optional): Eine Modell-ID, die default_text_model überschreibt.

  • Rückgabewert: Name des generierten Modells, generierter Text.

• generate_image — Generiert ein Bild aus einem Text-Prompt und speichert es als PNG/JPEG im angegebenen lokalen Ordner.

  • prompt (erforderlich): Die Beschreibung des zu generierenden Bildes.

  • output_dir (erforderlich): Absoluter Pfad des Zielverzeichnisses (wird bei Bedarf automatisch erstellt).

  • file_prefix (optional, Standard image): Präfix des gespeicherten Dateinamens.

  • number_of_images (optional, Standard 1, maximal 4): Anzahl der zu generierenden Bilder.

  • aspect_ratio (optional, Standard 1:1): 1:1 / 3:4 / 4:3 / 9:16 / 16:9.

  • negative_prompt (optional): Elemente, die nicht enthalten sein sollen.

  • model (optional): Eine Modell-ID, die default_image_model überschreibt.

  • Rückgabewert: Name des generierten Modells, Prompt, absoluter Pfad/MIME-Typ jeder gespeicherten Datei usw.

Ergänzende Hinweise

• Als Abhängigkeit wird das offizielle Google-SDK @google/genai verwendet.

• Wenn Inhalte durch den Sicherheitsfilter blockiert werden oder die Antwort keine Inhalte enthält, wird ein Fehler zurückgegeben.

• Informationen zur Verwendung der Bildgenerierung (z. B. Artikel-Titelbilder, eingebettete Bilder im Text) und zur Einbindung in den Artikeltext finden Sie unter docs/tasks/eyecatch-image.md / docs/tasks/image-embed.md (auf der jeweiligen Projektseite).