contentstack-mcp

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.