👻 Ghost CMS Admin & Newsletter MCP Server

Ein produktionsreifer Model Context Protocol (MCP)-Server, der Streamable HTTP (MCP-Spezifikation), SSE und stdio unterstützt und es KI-Modellen (Claude, Cursor, Antigravity, ChatGPT, Cline, Zed usw.) ermöglicht, selbst gehostete Ghost CMS Blogs & Newsletter zu verwalten, zu kuratieren, zu entwerfen, zu veröffentlichen und zu administrieren.

Entwickelt für den eigenständigen Einsatz auf Ihrem VPS neben Ihrer Ghost-Instanz, hinter Docker, Coolify, Caddy oder Nginx.

⚡ Streamable HTTP-Endpunkte

Related MCP server: Ghost CMS MCP Server

🛠️ Enthaltene MCP-Tool-Katalog

📝 1. Beiträge & Newsletter

• ghost_list_posts: Blogbeiträge & Newsletter-Ausgaben suchen, filtern und paginieren (draft, published, scheduled, sent, all).

• ghost_get_post: Vollständigen Inhalt, HTML, mobiledoc/lexical, Tags, Autoren und E-Mail-Klick-/Zustellstatistiken abrufen.

• ghost_create_post: Blogbeiträge und Newsletter direkt aus Markdown oder HTML mit SEO-Metadaten, Tags, Autoren, Auszügen und benutzerdefinierter Zeitplanung erstellen.

• ghost_update_post: Vorhandene Beiträge mit automatischer Nebenläufigkeitssynchronisierung (updated_at) bearbeiten.

• ghost_delete_post: Einen Beitrag dauerhaft per ID löschen.

• ghost_publish_and_send_newsletter: Einmaliges Veröffentlichen & E-Mail-Versand an Abonnenten-Stufen (all, status:free, status:paid).

📄 2. Statische Seiten

• ghost_list_pages, ghost_get_page, ghost_create_page, ghost_update_page, ghost_delete_page: Vollständiger Lebenszyklus statischer Seiten (Über uns, Kontakt, Landingpages).

💌 3. Newsletter & E-Mail-Konfiguration

• ghost_list_newsletters: Alle E-Mail-Newsletter der Publikation mit Mitgliederzahlen und Versandhistorie auflisten.

• ghost_get_newsletter, ghost_create_newsletter, ghost_update_newsletter: Absendernamen, Absender-E-Mails, Antwort-an und Standardeinstellungen für Abonnenten verwalten.

👥 4. Mitglieder & Abonnenten

• ghost_list_members: Abonnenten nach E-Mail, Name, Abonnementstufe und Labels suchen und filtern.

• ghost_get_member, ghost_create_member, ghost_update_member, ghost_delete_member: Verwaltung von Abonnentenprofilen und Zuweisung von Komplementär-Stufen.

• ghost_add_member_labels: Segmentierungslabels zu Mitgliedern hinzufügen.

🏷️ 5. Tags, Stufen, Einstellungen, Medien & Webhooks

• Tags: ghost_list_tags, ghost_get_tag, ghost_create_tag, ghost_update_tag, ghost_delete_tag (einschließlich interner #tags).

• Stufen & Angebote: ghost_list_tiers, ghost_list_offers (Kostenlose & kostenpflichtige Mitgliedschaften, Preise, Gutscheine).

• Site-Einstellungen & Diagnose: ghost_get_site_info, ghost_test_connection.

• Medien-Uploads: ghost_upload_image (lokale Dateien, Web-URLs oder base64-Bilder zu Ghost für Feature-Bilder hochladen).

• Webhooks: ghost_list_webhooks, ghost_create_webhook, ghost_delete_webhook.

📦 MCP-Ressourcen & Prompts

Ressourcen

• ghost://site/info – Publikationstitel, URL, Version und globale Konfiguration.

• ghost://newsletters – Aktive E-Mail-Newsletter mit Abonnentenzahlen.

• ghost://tiers – Verfügbare Mitgliedschaftsstufen und Preismodelle.

• ghost://posts/recent – Die 10 neuesten veröffentlichten Beiträge.

• ghost://members/summary – Mitgliederzahlen und aktuelle Abonnentenaktivitäten.

Prompts

• draft-blog-post – Geführte interaktive Vorlage zum Erstellen eines SEO-optimierten Blogbeitrags mit Tags, Auszügen und Formatierung.

• draft-newsletter – Strukturieren und Schreiben einer ansprechenden E-Mail-Newsletter-Ausgabe, bereit für den Versand.

• ghost-content-audit – Vollständige redaktionelle Überprüfung aktueller Beiträge, Tag-Hygiene und Empfehlungen zum Publikumswachstum.

🔑 Ghost Admin API-Einrichtung

1. Öffnen Sie Ihr Ghost-Admin-Dashboard (https://your-blog.ghost.io/ghost oder http://localhost:2368/ghost).

2. Gehen Sie zu Einstellungen (Zahnrad-Symbol) ➔ Integrationen.

3. Klicken Sie auf Benutzerdefinierte Integration hinzufügen.

4. Benennen Sie sie (z. B. AI Admin Assistant oder MCP Server).

5. Kopieren Sie:

   • Admin-API-URL (z. B. http://localhost:2368 oder https://blog.yourdomain.com)

   • Admin-API-Schlüssel (z. B. 64a7c8e2b0123456789abcde:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef)

🚀 Coolify- & VPS-Bereitstellung neben Ghost

Bereitstellung auf Coolify (Zero-Config Reverse Proxy & SSL)

Coolify übernimmt automatisch Traefik-Reverse-Proxy, Let's Encrypt SSL-Zertifikate, Docker-Netzwerke und Bereitstellungen ohne Ausfallzeiten.

1. Neue Ressource in Coolify aus Ihrem Git-Repository erstellen.

2. Basisverzeichnis auf /ghost-admin-mcp setzen (oder Root, wenn eigenständiges Repo).

3. Build-Pack auf Dockerfile und Port auf 8765 setzen.

4. Umgebungsvariablen konfigurieren:

   • GHOST_ADMIN_API_URL: https://blog.yourdomain.com

   • GHOST_ADMIN_API_KEY: <your-admin-api-key>

   • MCP_AUTH_TOKEN: <your-random-token>

   • PORT: 8765

   • TRANSPORT: streamable-http

5. Health-Check-Pfad auf /health setzen.

6. Ihre Domain festlegen (z. B. https://mcp.yourdomain.com) — Coolify übernimmt SSL automatisch!

Für Multi-Container-Docker-Compose in Coolify siehe COOLIFY.md.

🔌 Verbinden von Remote-KI-Clients

Streamable HTTP (MCP Remote Client / Cursor / Claude)

Konfigurieren Sie Ihren Remote-Client für die Verbindung mit:

• URL: https://mcp.yourdomain.com/mcp

• Header:

{
  "Authorization": "Bearer your_custom_secret_bearer_token"
}

Lokales Stdio (Claude Desktop / Cursor lokaler Fallback)

{
  "mcpServers": {
    "ghost-admin": {
      "command": "node",
      "args": ["/path/to/ghost-admin-mcp/dist/index.js"],
      "env": {
        "GHOST_ADMIN_API_URL": "https://blog.yourdomain.com",
        "GHOST_ADMIN_API_KEY": "your_key_id:your_secret_key"
      }
    }
  }
}

🧪 Testen

bun test

📄 Lizenz

MIT