Directus MCP-Server

Ein Node.js-Server, der das Model Context Protocol (MCP) für Directus CMS implementiert. Ermöglichen Sie KI-Clients die Interaktion mit der Directus-API über das Model Context Protocol (MCP).

ℹ Voraussetzungen

• Node.js

• NPM

• Eine Directus-Instanz

Related MCP server: Node Omnibus MCP Server

▶️ Schnellstart

1. Holen Sie sich Ihre Directus-API-Zugangsdaten

   • Gehen Sie zu Ihrer Directus-Instanz

   • Erstellen Sie ein statisches Zugriffstoken oder verwenden Sie Ihre E-Mail-Adresse und Ihr Passwort

   • Bewahren Sie diese Zugangsdaten sicher auf

2. Zu Ihrem KI-Editor hinzufügen

   {
     "mcpServers": {
       "directus": {
         "command": "npx",
         "args": ["-y", "@pixelsock/directus-mcp@latest"],
         "env": {
           "DIRECTUS_URL": "https://your-directus-instance.com",
           "DIRECTUS_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN"
         }
       }
     }
   }

   Alternativ können Sie die E-Mail/Passwort-Authentifizierung verwenden:

   {
     "mcpServers": {
       "directus": {
         "command": "npx",
         "args": ["-y", "@pixelsock/directus-mcp@latest"],
         "env": {
           "DIRECTUS_URL": "https://your-directus-instance.com",
           "DIRECTUS_EMAIL": "your-email@example.com",
           "DIRECTUS_PASSWORD": "your-password"
         }
       }
     }
   }

   Für Cursor:

   1. Gehen Sie zu Settings → Cursor Settings → MCP

   2. Klicken Sie auf + Add New Global MCP Server

   3. Fügen Sie die Konfiguration ein

   4. Ersetzen Sie die Platzhalterwerte durch Ihre Directus-Zugangsdaten

   5. Speichern und starten Sie Cursor neu

   Für Claude Desktop:

   1. Öffnen Sie Settings → Developer

   2. Klicken Sie auf Edit Config

   3. Öffnen Sie claude_desktop_config.json in einem Code-Editor und fügen Sie die Konfiguration ein

   4. Ersetzen Sie die Platzhalterwerte durch Ihre Directus-Zugangsdaten

   5. Speichern und starten Sie Claude neu

❓ Fehlerbehebung

Wenn Sie Probleme beim Starten des Servers in Ihrem MCP-Client haben (z. B. Cursor oder Claude Desktop), versuchen Sie bitte Folgendes.

Stellen Sie sicher, dass Sie gültige Directus-Zugangsdaten haben

1. Überprüfen Sie, ob Ihre Directus-URL korrekt und erreichbar ist

2. Überprüfen Sie, ob Ihr Zugriffstoken oder Ihre E-Mail/Passwort-Zugangsdaten gültig sind

3. Ersetzen Sie die Zugangsdaten in Ihrer MCP-Client-Konfiguration

4. Speichern und starten Sie Ihren MCP-Client neu

Stellen Sie sicher, dass Node und NPM installiert sind

• Node.js

• NPM

Führen Sie die folgenden Befehle aus, um zu bestätigen, dass Node und NPM installiert sind:

node -v
npm -v

Leeren Sie Ihren NPM-Cache

Manchmal kann das Leeren Ihres NPM-Caches Probleme mit npx lösen.

npm cache clean --force

🛠️ Verfügbare Tools

Sammlungen und Elemente

getItems                // Get items from a collection
getItem                 // Get a single item from a collection by ID
createItem              // Create a new item in a collection
updateItem              // Update an existing item in a collection
deleteItem              // Delete an item from a collection
getCollections          // Get all collection schemas
getFields               // Get fields for a collection
getRelations            // Get relations for a collection

Dateien

getFiles                // Get files from Directus
uploadFile              // Upload a file to Directus

Benutzer und Berechtigungen

login                   // Login to Directus and get an access token
getUsers                // Get users from Directus
getCurrentUser          // Get the current user info
getRoles                // Get roles from Directus
getPermissions          // Get permissions from Directus

System

getSystemInfo           // Get system information from Directus
getActivity             // Get activity logs from Directus
getConfig               // Get current configuration information

🚧 Entwicklungsmodus

Wenn Sie den Server im Entwicklungsmodus ausführen möchten:

1. Klonen und installieren:

   git clone https://github.com/pixelsock/directus-mcp.git
   cd directus-mcp
   npm install

2. Fügen Sie Ihre Zugangsdaten zu .env hinzu:

   # .env
   DIRECTUS_URL=https://your-directus-instance.com
   DIRECTUS_ACCESS_TOKEN=your_token_here
   # Or use email/password
   DIRECTUS_EMAIL=your-email@example.com
   DIRECTUS_PASSWORD=your-password

3. Starten Sie den Entwicklungsserver:

   npm run dev

🌐 HTTP-Transport (Multi-User / Remote-Bereitstellungen)

Standardmäßig verwendet der Server den stdio-Transport, der ideal für lokale KI-Editoren für einzelne Benutzer (Cursor, Claude Desktop usw.) ist.

Für Multi-User- oder Remote-Umgebungen können Sie zum Streamable HTTP-Transport wechseln, indem Sie die Umgebungsvariable MCP_TRANSPORT festlegen.

Konfiguration

Sie können auch --transport=http als CLI-Argument übergeben, anstatt die Umgebungsvariable festzulegen.

Ausführen des HTTP-Servers

# Via environment variable
MCP_TRANSPORT=http MCP_PORT=3000 MCP_HOST=0.0.0.0 node dist/index.js

# Via CLI argument
node dist/index.js --transport=http

Docker-Beispiel

docker run -p 3000:3000 \
  -e DIRECTUS_URL=https://your-directus-instance.com \
  -e DIRECTUS_ACCESS_TOKEN=your_token_here \
  -e MCP_TRANSPORT=http \
  -e MCP_HOST=0.0.0.0 \
  ghcr.io/pixelsock/directus-mcp

Verbinden eines MCP-Clients mit dem HTTP-Server

Sobald der Server läuft, konfigurieren Sie Ihren MCP-Client für die Verbindung mit:

http://<host>:<port>/mcp

Zum Beispiel mit einem Client, der den Streamable HTTP-Transport unterstützt:

{
  "mcpServers": {
    "directus": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

📄 Directus-Entwicklerressourcen

• Directus-API-Dokumentation

• Directus-API-Endpunkte

• Directus JavaScript SDK