MCP, czyli Model Context Protocol, to nowy protokół dla dużych modeli językowych (LLM) zaproponowany przez Anthropic. Jest to zestaw standardów i wytycznych, które mają na celu ujednolicenie sposobu, w jaki modele AI interpretują instrukcje i kontekst.

Zobacz także film: Jak działa serwer MCP.

O serwerze MCP WordPress Gutenberg

MCP WordPress-Gutenberg to specjalny serwer stworzony w standardzie zgodnym z MCP, dzięki czemu można go zastosować w połączeniu z różnymi modelami sztucznej inteligencji.

W serwerze zostały zdefiniowane specjalne narzędzia, które można skategoryzować w 3 grupy:

• WP REST API – narzędzie wymagające połączenia z REST API WordPress’a
• WP CLI – narzędzia wymagające połączenia z WP CLI dla WordPress’a
• FILESYSTEM – narzędzia wykonujące operacje bezpośrednio na plikach poprzez narzędzia systemowe, korzystające także z Node.js, NPM i NPX.

Aby zobaczyć jakie możliwości daje MCP WordPress Gutenberg zobacz film: AI + WordPress – Poznaj możliwości MCP

Wymagania

Aby poprawnie uruchomić MCP for WordPress and Gutenberg w środowisku Cursor AI, konieczne jest spełnienie poniższych warunków:

• Docker Desktop – Środowiska uruchomieniowe dla serwer MCP
• Lokalna instancja WordPressa – MCP komunikuje się z Twoją stroną za pomocą WP REST API / WP CLI i wymaga działającego środowiska z dostępem przez HTTP oraz dostępem do bazy danych
• Klient MCP – aplikacja zgodna ze standardem MCP

Konfiguracja serwera MCP

Aby korzystać z MCP for WordPress and Gutenberg, potrzebujesz klienta, który obsługuje serwery MCP i potrafi integrować się z narzędziami deweloperskimi opartymi na AI. Najpopularniejszymi klientami, z którymi MCP WordPress Gutenberg działa bezproblemowo, są:

• Cursor AI – nowoczesny edytor kodu zintegrowany z AI, wspiera konfigurację wielu serwerów MCP i posiada wbudowany interfejs do wysyłania zapytań.
• Claude Desktop – aplikacja desktopowa oparta na modelach Claude od Anthropic, pozwala na łączenie się z lokalnymi serwerami MCP i pracę z kontekstem projektu.

Możliwe jest również wykorzystanie innych klientów MCP, które wspierają standardowe zapytania do lokalnych serwerów MCP. Pełna lista klientów MCP znajduje się na oficjalnych stronach dokumentacji Model Context Protocol.

Konfiguracja serwera MCP na Docker w Cursor AI

Otwórz edytor Cursor AI i załaduj projekt, w którym znajduje się Twoje środowisko WordPress. Jeśli Twój projekt nie zawiera jeszcze katalogu .cursor, należy go utworzyć w głównym katalogu projektu. Konfiguracja serwerów MCP odbywa się w pliku .cursor/mcp.json, jeśli nie posiadasz takiego pliku to utwórz go ręcznie.

Schemat konfiguracji serwer MCP WordPress Gutenberg w pliku mcp.json:

{
  "mcpServers": {
    ... inne serwery MCP
    "mcp-wordpress-gutenberg": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-v ./:/app",
        "public.ecr.aws/k5f9z1b4/ctowiec/mcp-wordpress-gutenberg:0.0.1-beta"
      ]
    }
  }
}

Konfiguracja serwera MCP na Docker w Claude Desktop

Konfiguracja w Claude Desktop wygląda analogicznie, jak konfiguracja dla aplikacji Cursor AI. W ustawieniach należy wejść w zakładkę: „Developer” a następnie nacisnąć przycisk „Edit config”. Wskazany zostanie pliku w formacie JSON, który należy wyedytować zgodnie z przykładami opisanymi na tej stronie.

Konfiguracja projektu

W katalogu głównym, który zostaje zamontowany do kontenera Docker musi zostać przygotowany specjalny plik konfiguracyjny wp-sites.json, który definiuje dostęp do serwisów na WordPress. Przykładowa treść pliku:

{
  "sites": {
    "site1": {
      "name": "Example Site 1",
      "baseUrl": "http://example-site1.local/",
      "apiCredentials": {
        "username": "mcp",
        "password": ""
      }
    }
  }
}

• name – zawiera nazwę strony, może to być dowolna wartość
• baseUrl – pole definiuje adres strony WordPress’a. Adres musi być osiągalny dla requestów z kontenera Docker z serwerem MCP
• apiCredentials – obiekt definiuje dane dostępowe do WP REST API. Aby skonfigurować połączenie musisz stworzyć nowe hasło aplikacji w panelu WordPress.

W ramach jednej konfiguracji pliku wp-sites.json możesz dodać wiele konfiguracji stron na WordPressie.

Troubleshooting

Uruchomienie na Windows

W przypadku systemu Windows, ścieżki do folderów wolumenów muszą być absolutne. Podwójny backslash („\\”) zabezpiecza format JSON przed błędem niepoprawnej składni.

{
  "mcpServers": {
    ... inne serwery MCP
    "mcp-wordpress-gutenberg": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-v C:\\absolutna\\sciezka\\do\\folderu\\z\\wordpressem:/app",
        "public.ecr.aws/k5f9z1b4/ctowiec/mcp-wordpress-gutenberg:0.0.1-beta"
      ]
    }
  }
}

Uruchomienie na MacOs

W przypadku użytkowników korzystających z Docker na systemie MacOS mogą wystąpić specyficzne problemy. W niektórych przypadkach Docker na MacOS może mieć problemy z resolverem DNS dla domen lokalnych. Jeśli twoja konfiguracja WordPress używa domen lokalnych (np. local.site), możesz dodać parametr --add-host=local.site:host-gateway do argumentów args w konfiguracji MCP.

{
  "mcpServers": {
    "mcp-wordpress-gutenberg": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-v ./sciezka/do/wordpress:/app",
        "public.ecr.aws/k5f9z1b4/ctowiec/mcp-wordpress-gutenberg:0.0.1-beta"
      ]
    }
  }
}

Gdzie ./sciezka/do/wordpress to ścieżka względna do katalogu, w którym znajduje się instalacja WordPress.

Uruchomienie w istniejącej sieci Docker

Jeśli twoje środowisko WordPress działa już w sieci Docker, możesz podłączyć serwer MCP do tej samej sieci. Dodaj parametry sieci do argumentów w pliku mcp.json: "--network=nazwa-twojej-sieci".

Odczytywanie logów serwera MCP

Serwer MCP WordPress Gutenberg zapisuje logi, które mogą być pomocne przy rozwiązywaniu problemów. Domyślnie logi są zapisywane w katalogu /logs/mcp-wordpress-gutenberg.log wewnątrz kontenera. Aby uzyskać do nich dostęp, możesz np. zamontować katalog logów jako wolumen: "-v ./logs:/logs„. Następnie możesz przeglądać logi w katalogu ./logs na swoim komputerze.

Lista narzędzi w MCP WordPress Gutenberg