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

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).
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.
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.
Verwaltungsoberfläche:
- Bereitstellung einer React-basierten Verwaltungsoberfläche, die es Benutzern ermöglicht, Authentifizierungs-Token und andere Konfigurationen im WordPress-Backend zu verwalten.
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

Repository klonen:

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

Abhängigkeiten installieren:

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

Plugin aktivieren:
- Aktivieren Sie das WordPress MCP-Plugin im WordPress-Backend auf der Seite "Plugins".
MCP-Funktionen konfigurieren:
- Navigieren Sie zu "Einstellungen > WordPress MCP", aktivieren Sie die MCP-Funktionen und konfigurieren Sie Authentifizierungs-Token.

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

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:

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.
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.
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).
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:

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'];
    }
}

Tool registrieren:
- Registrieren Sie das neue Tool bei der Plugin-Initialisierung, um sicherzustellen, dass es über die MCP-Schnittstelle verfügbar ist.
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.

wordpress-mcp