WordPress MCP Projekt – Detaillierte Beschreibung

Projektübersicht

WordPress MCP (Model Context Protocol) ist ein von Automattic entwickeltes WordPress-Plugin, das WordPress-Seiten in einen einfachen MCP-Server verwandelt. Es stellt die Seitenfunktionen über die WordPress REST API bereit, sodass große Sprachmodelle (LLMs) und KI-Agenten mit ihnen interagieren können. Das Projekt ermöglicht es Entwicklern, KI-Tools für die Automatisierung von Aufgaben wie Content-Management, Benutzeraktionen und Seitenkonfiguration zu nutzen, um die Entwicklungseffizienz und Integrationsfähigkeit zu verbessern.

Kernfunktionen

1. MCP-Server-Unterstützung:

   • Bereitstellung von MCP-Serverfunktionen über REST API-Routen (z. B. /wp/v2/wpmcp und /wp/v2/wpmcp/streamable), um die Interaktion von KI-Agenten mit WordPress zu unterstützen.
   • Unterstützung von zwei Transportschichten: McpStdioTransport (Standard Ein-/Ausgabe) und McpStreamableTransport (Streaming-Übertragung, geeignet für SSE oder andere Streaming-Protokolle).

2. Authentifizierungsmechanismus:

   • Verwendung eines JWT-Authentifizierungssystems (JSON Web Token) zur Gewährleistung einer sicheren Kommunikation.
   • Unterstützung von WordPress-Anwendungspasswörtern (Application Passwords) sowie WooCommerce REST API-Verbraucherschlüsseln und geheimen Schlüsseln zur Erhöhung der Sicherheit.

3. Methoden-Handler:

   • Bereitstellung von Methoden-Handlern wie Tools, Ressourcen und Prompts zur Unterstützung von Content-Management, Seiteninitialisierung usw.
   • Erweiterung der Funktionen durch benutzerdefinierte Tools möglich, um spezifische Anforderungen zu erfüllen.

4. Verwaltungsoberfläche:

   • Bereitstellung einer React-basierten Verwaltungsoberfläche, die es Benutzern ermöglicht, Authentifizierungs-Token und andere Konfigurationen im WordPress-Backend zu verwalten.

5. Kompatibilität mit MCP-Clients:

   • Nahtlose Zusammenarbeit mit MCP-kompatiblen Clients (z. B. Claude Desktop), Unterstützung von REST API-Anfragen über Proxys (z. B. mcp-wordpress-remote), ohne dass eine ständig offene Verbindung erforderlich ist.

Projektmerkmale

• Sicherheit: Gewährleistung der Datensicherheit durch JWT-Authentifizierung und Anwendungspasswörter, empfohlene Verwendung von HTTPS zur Verschlüsselung der Kommunikation.
• Erweiterbarkeit: Unterstützung für Entwickler, die Plugin-Funktionen durch Hinzufügen benutzerdefinierter Tools, Ressourcen und Prompts erweitern können.
• Entwicklerfreundlich: Bereitstellung detaillierter Testdokumentation (tests/README.md) und eines Leitfadens für Beiträge, um die Beteiligung der Community an der Entwicklung zu fördern.
• Leichtgewichtig und effizient: Der Proxy-Modus vermeidet ständig offene Verbindungen, optimiert die Leistung und eignet sich für die lokale Entwicklung und Remote-Bereitstellung.
• Open-Source-Lizenz: Verwendung der GPL v2 oder einer höheren Version, offen für die WordPress- und KI-Community.

Technische Architektur

Die Kernarchitektur des Projekts umfasst die folgenden Module:

• Transportschicht (Transport Layer):

  • McpStdioTransport: Verarbeitung von MCP-Anfragen über Standard Ein-/Ausgabe, geeignet für die lokale Entwicklung.
  • McpStreamableTransport: Unterstützung von Streaming-Übertragung, geeignet für Echtzeit-Interaktionsszenarien (derzeit möglicherweise nicht von allen Clients unterstützt).

• Authentifizierungssystem (Authentication):

  • Verwendung der JWT-Authentifizierung, WPMCP_JWT_SECRET_KEY muss in wp-config.php definiert werden.
  • Unterstützung von WordPress-Anwendungspasswörtern und WooCommerce-Schlüsseln zur Erhöhung der Flexibilität.

• Methoden-Handler (Method Handlers):

  • Tools: Implementierung von Operationen wie Erstellung, Aktualisierung und Löschung von Inhalten.
  • Ressourcen: Bereitstellung von Schnittstellen für den Zugriff auf Seitendaten.
  • Prompts: Bereitstellung von Kontextleitfäden für KI-Agenten.
  • Systeminitialisierung (System & Initialization): Verarbeitung des Starts und der Konfiguration des MCP-Servers.

• Verwaltungsoberfläche (Admin Interface):

  • Erstellt mit React, befindet sich im WordPress-Backend unter "Einstellungen > WordPress MCP" und dient zur Verwaltung von Authentifizierungs-Token und Funktionsschaltern.

Installation und Konfiguration

Installationsschritte

1. Repository klonen:

   cd wp-content/plugins/
   git clone https://github.com/Automattic/wordpress-mcp.git
   cd wordpress-mcp
   

2. Abhängigkeiten installieren:

   composer install --no-dev
   npm install && npm run build
   

3. Plugin aktivieren:

   • Aktivieren Sie das WordPress MCP-Plugin im WordPress-Backend auf der Seite "Plugins".

4. MCP-Funktionen konfigurieren:

   • Navigieren Sie zu "Einstellungen > WordPress MCP", aktivieren Sie die MCP-Funktionen und konfigurieren Sie Authentifizierungs-Token.

5. JWT-Schlüssel konfigurieren: Fügen Sie in wp-config.php Folgendes hinzu:

   define('WPMCP_JWT_SECRET_KEY', 'your-secret-key');
   define('WPMCP_DEBUG', true); // Enable debug logging
   

6. Remote-Client installieren (optional):

   • Zur Verwendung mit mcp-wordpress-remote, Installationsbefehl wie folgt:

     npx @modelcontextprotocol/inspector \
     -e WP_API_URL=https://your-site.com/ \
     -e JWT_TOKEN=your-jwt-token-here \
     npx @automattic/mcp-wordpress-remote@latest
     

Konfigurationshinweise

• Sicherheit: Übertragen Sie Authentifizierungs-Token niemals an ein Versionskontrollsystem, stellen Sie sicher, dass WPMCP_JWT_SECRET_KEY sicher gespeichert wird.
• Debugging: Durch Aktivieren von WPMCP_DEBUG können Debug-Protokolle aufgezeichnet werden, um die Fehlerbehebung zu erleichtern.
• Löschvorgänge: Das Löschen von Tools kann zu dauerhaftem Datenverlust führen, aktivieren Sie diese Funktion nur für vertrauenswürdige Benutzer.
• Abhängigkeit vom Remote-Client: Das WordPress MCP-Plugin muss in Verbindung mit mcp-wordpress-remote verwendet werden, um den vollen Funktionsumfang zu erreichen.

Anwendungsfälle

Das WordPress MCP-Projekt eignet sich für die folgenden Szenarien:

1. Automatisierte Inhaltsverwaltung:

   • Erstellen, Aktualisieren oder Löschen von Artikeln, Seiten, Benutzern usw. durch KI-Agenten, um manuelle Bedienungszeit zu sparen.
   • Beispiel: Verwenden Sie den Claude Desktop-Befehl "Erstellen Sie 10 Entwurfsartikel mit dem Titel 'Testartikel #1–10'", um automatisch Testinhalte zu generieren.

2. Entwicklung und Tests:

   • Entwickler können MCP-Tools verwenden, um schnell Testdaten zu generieren und so Funktionstests und Integrationsentwicklung zu beschleunigen.
   • Beispiel: Vereinfachen Sie den Debugging-Prozess, indem Sie KI-Agenten verwenden, um Debug-Protokolle abzufragen und Probleme zusammenzufassen.

3. Seitenverwaltung:

   • Remote-Verwaltung von Seitenkonfigurationen, Benutzerberechtigungen oder Mediendateien, geeignet für die Zusammenarbeit in verteilten Teams.
   • Unterstützung der WooCommerce-Integration zur Verwaltung von E-Commerce-bezogenen Daten (z. B. Bestellungen, Produkte).

4. KI-gesteuerte Anpassung:

   • Entwickler können benutzerdefinierte Tools hinzufügen, um bestimmte Geschäftslogiken freizulegen und individuelle Anforderungen zu erfüllen.
   • Beispiel: Erstellen Sie benutzerdefinierte Tools, um Artikelkategorien oder SEO-Metadaten in großen Mengen zu aktualisieren.

Erweiterung und Entwicklung

Hinzufügen benutzerdefinierter Tools

Entwickler können die Plugin-Funktionen mit den folgenden Schritten erweitern:

1. Tool-Datei erstellen:

   • Fügen Sie im Verzeichnis wp-content/plugins/wordpress-mcp/includes/Tools/ eine neue Tool-Klasse hinzu.
   • Beispiel für eine Tool-Klasse:

     <?php
     namespace WPMCP\Tools;
     class CustomTool {
         public function execute($params) {
             // Implementieren Sie benutzerdefinierte Logik
             return ['success' => true, 'data' => 'Custom tool executed'];
         }
     }
     

2. Tool registrieren:

   • Registrieren Sie das neue Tool bei der Plugin-Initialisierung, um sicherzustellen, dass es über die MCP-Schnittstelle verfügbar ist.

3. Vorhandene Implementierungen referenzieren:

   • Sehen Sie sich den Beispielcode in den Verzeichnissen includes/Tools/, includes/Resources/ und includes/Prompts/ an.

Code beitragen

• Leitfaden für Beiträge: Beachten Sie die Contributing Guidelines im Repository, senden Sie Pull Requests oder melden Sie Issues.
• Testdokumentation: Sehen Sie sich tests/README.md an, um den Testprozess zu verstehen und die Codequalität sicherzustellen.
• Lizenzanforderungen: Alle Beiträge müssen der GPL v2 oder einer höheren Version entsprechen.

Verwandte Ressourcen

• GitHub-Repository: https://github.com/Automattic/wordpress-mcp
• Remote-Client: https://github.com/Automattic/mcp-wordpress-remote
• WordPress MCP-Website: https://mcp-wp.github.io