Ghost MCP Server

Ein Model Context Protocol (MCP)-Server für die Interaktion mit Ghost CMS über LLM-Schnittstellen wie Claude. Dieser Server bietet sicheren und umfassenden Zugriff auf Ihren Ghost-Blog, nutzt JWT-Authentifizierung und eine umfangreiche Sammlung von MCP-Tools zur Verwaltung von Beiträgen, Benutzern, Mitgliedern, Stufen, Angeboten und Newslettern.

Funktionen

• Sichere Ghost-Admin-API-Anfragen mit @tryghost/admin-api

• Umfassender Zugriff auf Entitäten, einschließlich Beiträgen, Benutzern, Mitgliedern, Stufen, Angeboten und Newslettern

• Erweiterte Suchfunktion mit sowohl unscharfer als auch exakter Übereinstimmung

• Detaillierte, menschenlesbare Ausgabe für Ghost-Entitäten

• Robuste Fehlerbehandlung mit benutzerdefinierten GhostError-Ausnahmen

• Integrierte Protokollierungsunterstützung über den MCP-Kontext für verbesserte Fehlerbehebung

Verwendung

Um dies mit MCP-Clients zu verwenden, z. B. mit Claude Desktop, fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
      "ghost-mcp": {
        "command": "npx",
        "args": ["-y", "@fanyangmeng/ghost-mcp"],
        "env": {
            "GHOST_API_URL": "https://yourblog.com",
            "GHOST_ADMIN_API_KEY": "your_admin_api_key",
            "GHOST_API_VERSION": "v5.0"
        }
      }
    }
}

Verfügbare Ressourcen

Die folgenden Ghost-CMS-Ressourcen sind über diesen MCP-Server verfügbar:

• Posts: Artikel und Inhalte, die auf Ihrer Ghost-Website veröffentlicht werden.

• Pages: Eigenständige Seiten (Über, Landing, Pillar-Seiten) – dieselben Felder wie Beiträge, einschließlich aller SEO-/Social-Metadaten.

• Members: Registrierte Benutzer und Abonnenten Ihrer Website.

• Newsletters: E-Mail-Newsletter, die über Ghost verwaltet und versendet werden.

• Offers: Werbeangebote und Rabatte für Mitglieder.

• Invites: Einladungen für neue Benutzer oder Mitarbeiter, Ihrer Ghost-Website beizutreten.

• Roles: Benutzerrollen und Berechtigungen innerhalb der Ghost-Administration.

• Tags: Organisatorische Tags für Beiträge und Inhalte.

• Tiers: Abonnementstufen und Pläne für Mitglieder.

• Users: Admin-Benutzer und Mitarbeiterkonten.

• Webhooks: Automatisierte Ereignisbenachrichtigungen an externe Dienste.

Verfügbare Werkzeuge

Dieser MCP-Server stellt eine umfassende Sammlung von Werkzeugen zur Verwaltung Ihres Ghost CMS über das Model Context Protocol bereit. Jede Ressource bietet eine Reihe von Operationen, die typischerweise das Durchsuchen, Lesen, Erstellen, Bearbeiten und Löschen von Entitäten umfassen. Im Folgenden finden Sie eine Zusammenfassung der verfügbaren Werkzeuge:

Posts

• Browse Posts: Listen Sie Beiträge mit optionalen Filtern, Paginierung und Sortierung auf.

• Read Post: Rufen Sie einen Beitrag anhand der ID oder des Slugs ab.

• Add Post: Erstellen Sie einen neuen Beitrag mit Titel, Inhalt und Status.

• Edit Post: Aktualisieren Sie einen vorhandenen Beitrag anhand der ID.

• Delete Post: Entfernen Sie einen Beitrag anhand der ID.

Pages

• Browse Pages: Listen Sie Seiten mit optionalen Filtern, Paginierung und Sortierung auf.

• Read Page: Rufen Sie eine einzelne Seite anhand der ID oder des Slugs ab.

• Add Page: Erstellen Sie eine neue Seite.

• Edit Page: Aktualisieren Sie eine Seite. Wenn Sie html/lexical weglassen, bleibt der Inhalt unverändert, was reine Metadaten-Änderungen sicher macht.

• Delete Page: Entfernen Sie eine Seite.

Bearbeitbare Felder umfassen slug, status, visibility, featured, published_at, custom_excerpt, feature_image (+ _alt, _caption), show_title_and_feature_image, meta_title, meta_description, og_title, og_description, og_image, twitter_title, twitter_description, twitter_image, codeinjection_head, codeinjection_foot, canonical_url, tags und authors.

Members

• Browse Members: Listen Sie Mitglieder mit Filtern und Paginierung auf.

• Read Member: Rufen Sie ein Mitglied anhand der ID oder E-Mail ab.

• Add Member: Erstellen Sie ein neues Mitglied.

• Edit Member: Aktualisieren Sie Mitgliederdetails.

• Delete Member: Entfernen Sie ein Mitglied.

Newsletters

• Browse Newsletters: Listen Sie Newsletter auf.

• Read Newsletter: Rufen Sie einen Newsletter anhand der ID ab.

• Add Newsletter: Erstellen Sie einen neuen Newsletter.

• Edit Newsletter: Aktualisieren Sie Newsletter-Details.

• Delete Newsletter: Entfernen Sie einen Newsletter.

Offers

• Browse Offers: Listen Sie Angebote auf.

• Read Offer: Rufen Sie ein Angebot anhand der ID ab.

• Add Offer: Erstellen Sie ein neues Angebot.

• Edit Offer: Aktualisieren Sie Angebotsdetails.

• Delete Offer: Entfernen Sie ein Angebot.

Invites

• Browse Invites: Listen Sie Einladungen auf.

• Add Invite: Erstellen Sie eine neue Einladung.

• Delete Invite: Entfernen Sie eine Einladung.

Roles

• Browse Roles: Listen Sie Rollen auf.

• Read Role: Rufen Sie eine Rolle anhand der ID ab.

Tags

• Browse Tags: Listen Sie Tags auf.

• Read Tag: Rufen Sie ein Tag anhand der ID oder des Slugs ab.

• Add Tag: Erstellen Sie ein neues Tag.

• Edit Tag: Aktualisieren Sie Tag-Details.

• Delete Tag: Entfernen Sie ein Tag.

Tiers

• Browse Tiers: Listen Sie Stufen auf.

• Read Tier: Rufen Sie eine Stufe anhand der ID ab.

• Add Tier: Erstellen Sie eine neue Stufe.

• Edit Tier: Aktualisieren Sie Stufendetails.

• Delete Tier: Entfernen Sie eine Stufe.

Users

• Browse Users: Listen Sie Benutzer auf.

• Read User: Rufen Sie einen Benutzer anhand der ID oder des Slugs ab.

• Edit User: Aktualisieren Sie Benutzerdetails.

• Delete User: Entfernen Sie einen Benutzer.

Webhooks

• Browse Webhooks: Listen Sie Webhooks auf.

• Add Webhook: Erstellen Sie einen neuen Webhook.

• Delete Webhook: Entfernen Sie einen Webhook.

Jedes Werkzeug ist über das MCP-Protokoll zugänglich und kann von kompatiblen Clients aufgerufen werden. Detaillierte Parameterschemata und Verwendung finden Sie im Quellcode unter src/tools/.

Fehlerbehandlung

Der Ghost MCP Server verwendet eine benutzerdefinierte GhostError-Ausnahme, um API-Kommunikationsfehler und Verarbeitungsprobleme zu behandeln. Dies gewährleistet klare und beschreibende Fehlermeldungen zur Unterstützung bei der Fehlerbehebung.

Mitwirken

1. Repository forken

2. Feature-Branch erstellen

3. Änderungen committen

4. Pull-Request erstellen

Lizenz

MIT