Contentstack MCP Server

Dieser Model Context Protocol (MCP)-Server lässt sich in die Content Management API von Contentstack integrieren und ermöglicht KI-Assistenten wie Claude die Interaktion mit Ihrem Contentstack CMS über ein standardisiertes Protokoll.

Hinweis: Dies ist eine frühe Version des Contentstack MCP Servers. Informationen zu kommenden Verbesserungen und geplanten Funktionen finden Sie in der Roadmap .

Inhaltsverzeichnis

• Merkmale

• Installation

• Entwicklung

• Konfiguration

• Integration mit KI-Assistenten

• Anwendungsbeispiele

• Fahrplan

• Lizenz

Merkmale

Verfügbare Ressourcen

• content-types : Listet alle Inhaltstypen auf (URI: contentstack://content-types )

• content-type : Inhaltstyp nach UID abrufen (URI: contentstack://content-type/{uid} )

• entries : Einträge nach Inhaltstyp abrufen (URI: contentstack://entries/{content_type_uid} )

• entry : Bestimmten Eintrag abrufen (URI: contentstack://entry/{content_type_uid}/{entry_uid} )

• assets : Listet alle Assets auf (URI: contentstack://assets )

Inhaltstypverwaltung

• Erstellen, Aktualisieren und Löschen von Inhaltstypen

• Definieren Sie Schemata, Optionen, Feldregeln und Taxonomien

• Verwalten globaler Felder

Einlassmanagement

• Einträge erstellen, aktualisieren und löschen

• Veröffentlichen und Aufheben der Veröffentlichung von Einträgen in verschiedenen Umgebungen

• Abfrageeinträge mit Filter-, Paginierungs- und Sortieroptionen

Globales Außendienstmanagement

• Erstellen und aktualisieren Sie globale Felder zur Wiederverwendung in verschiedenen Inhaltstypen

• Abrufen globaler Felder mit Paginierungsoptionen

Inhalts-Workflows

• Geführte Workflows zur Inhaltserstellung

• Inhaltsanalyse und Erkenntnisse

• Unterstützung bei der Migrationsplanung

Installation

Voraussetzungen

• Node.js (v16.0.0 oder höher)

• Ein Contentstack-Konto

• API-Anmeldeinformationen (API-Schlüssel und Verwaltungstoken)

NPM-Installation

Der einfachste Weg, diesen MCP-Server zu verwenden, ist über NPM:

Manuelle Installation

1. Klonen Sie das Repository:

   git clone https://github.com/darekrossman/contentstack-mcp.git cd contentstack-mcp

2. Installieren Sie Abhängigkeiten:

   npm install

3. Umgebungsvariablen einrichten:

   cp .env.example .env

   Bearbeiten Sie die .env Datei mit Ihren Contentstack-Anmeldeinformationen:

   CONTENTSTACK_API_KEY=your_api_key_here CONTENTSTACK_MANAGEMENT_TOKEN=your_management_token_here # Optional: Specify branch if using branches CONTENTSTACK_BRANCH=your_branch_name

4. Erstellen und starten Sie den Server:

   npm run build npm start

Installation über Smithery CLI

Sie können diesen MCP-Server auch mit der Smithery CLI installieren:

Weitere Einzelheiten und Informationen zur erweiterten Verwendung finden Sie in der Smithery CLI-Dokumentation .

Entwicklung

Setup für die Entwicklung

Für die Entwicklung können Sie Folgendes verwenden:

Dadurch wird der Server mithilfe von ts-node für einen schnelleren Entwicklungszyklus gestartet.

Codequalität

Dieses Projekt verwendet Biome.js für Lint-Tests und Formatierungen. Es sorgt für einen konsistenten Codestil und hilft, potenzielle Probleme frühzeitig zu erkennen.

Verfügbare Befehle

• Flusencode :

  npm run lint

• Fusseln und Fixieren :

  npm run lint:fix

• Formatcode :

  npm run format

• Formatieren und beheben :

  npm run format:fix

Konfiguration

Authentifizierung

Dieser Server erfordert eine Authentifizierung mit der API von Contentstack:

Verwaltungstoken (erforderlich) :

• Token auf Stapelebene mit vordefinierten Berechtigungen

• Wird über die Umgebungsvariable CONTENTSTACK_MANAGEMENT_TOKEN festgelegt

• Vom Contentstack-Dashboard generieren: Einstellungen > Token > Verwaltungstoken

API-Schlüssel (erforderlich) :

• Stack-API-Schlüssel zur Authentifizierung

• Wird über die Umgebungsvariable CONTENTSTACK_API_KEY festgelegt

Filialunterstützung

Wenn Ihr Contentstack-Konto Zweige verwendet, können Sie einen Zweig angeben:

Integration mit KI-Assistenten

Claude für Desktop

So verwenden Sie diesen Server mit Claude für Desktop:

1. Bearbeiten Sie Ihre Claude for Desktop-Konfigurationsdatei:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Fügen Sie diesen Server zum Abschnitt mcpServers hinzu:

   { "mcpServers": { "contentstack": { "command": "npx", "args": ["-y", "@drossman/contentstack-mcp"], "env": { "CONTENTSTACK_API_KEY": "your_api_key_here", "CONTENTSTACK_MANAGEMENT_TOKEN": "your_management_token_here" } } } }

3. Starten Sie Claude für Desktop neu

Cursor

Um diesen Server mit Cursor zu verwenden, fügen Sie die Contentstack MCP-Serverkonfiguration hinzu:

Mit Smithery installieren

Sie können diesen MCP-Server auch mithilfe der Smithery CLI und dem Client Ihrer Wahl installieren:

Zu den verfügbaren Clients gehören:

• Claude

• Cline

• Windsurfen

• Roocode

• witzig

• sprechen

• Cursor

• vscode

• vscode-Insider

• Boltai

• Amazon-Grundgestein

• amazonq

Weitere Einzelheiten und Informationen zur erweiterten Verwendung finden Sie in der Smithery CLI-Dokumentation .

Fahrplan

• [ ] Verbessertes kontextbezogenes Verständnis durch KI : Verbessern Sie die Kontextbereitstellung für komplexe Abfragen

• [ ] Erweiterte Abfragen und Filtern : Unterstützt das Filtern nach mehreren Kriterien und benutzerdefinierten Feldern

• [ ] Workflow- und Publishing-Automatisierung : Aktivieren Sie KI-gesteuerte Content-Workflow-Aktionen

• [ ] Verbesserungen im Asset Management : Hinzufügen von Funktionen zur direkten Asset-Manipulation

• [ ] Unterstützung für Massenvorgänge : Implementieren Sie Stapelvorgänge für Einträge und Vermögenswerte

• [ ] Verbesserte Fehlerbehandlung und KI-Feedback : Fehlermeldungen für den KI-Verbrauch verfeinern

• [ ] Benutzerspezifischer Kontext und Berechtigungen : Passen Sie Aktionen basierend auf Benutzerberechtigungen an

• [ ] Erweiterbarkeit für benutzerdefinierte Tools : Erstellen Sie ein Erweiterungsframework

• [ ] Echtzeit-Ereignisbehandlung : Fügen Sie Webhook-Unterstützung für reaktives KI-Verhalten hinzu

• [ ] Umfassende Dokumentation : Entwickeln Sie detaillierte Anleitungen für die KI-Interaktion

Shoutout

Besonderer Dank geht an Ivo Toby . Dieses Projekt und sein Autor sind stark von seiner Arbeit in diesem Bereich inspiriert.

Lizenz

MIT

Haftungsausschluss: Dieses Projekt steht in keiner Verbindung zu Contentstack und wird von Contentstack weder unterstützt noch gefördert. Es handelt sich um ein unabhängiges Open-Source-Projekt, das für die Zusammenarbeit mit der Contentstack-API entwickelt wurde.