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 .

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:

# Install globally
npm install -g @drossman/contentstack-mcp

# Or use directly via npx
npx @drossman/contentstack-mcp

Manuelle Installation

Klonen Sie das Repository:
git clone https://github.com/darekrossman/contentstack-mcp.git cd contentstack-mcp
Installieren Sie Abhängigkeiten:
npm install
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
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:

npx @smithery/cli install contentstack-mcp --client claude

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:

npm run dev

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:

CONTENTSTACK_BRANCH=develop

Integration mit KI-Assistenten

Claude für Desktop

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

Bearbeiten Sie Ihre Claude for Desktop-Konfigurationsdatei:
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
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" } } } }
Starten Sie Claude für Desktop neu

Cursor

Um diesen Server mit Cursor zu verwenden, fügen Sie die Contentstack MCP-Serverkonfiguration 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",
      }
      }
   }
}

Mit Smithery installieren

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

npx -y @smithery/cli install @drossman/contentstack-mcp --client claude

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.

contentstack-mcp

Integrations