Install
Upload it under Plugins → Add New Plugin → Upload Plugin, then activate.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/inyfinn/inyfinn-cursor-bridge-mcp/releases/download/v1.7.3/inyfinn-cursor-bridge-mcp-1.7.3.zipRepo: https://github.com/inyfinn/inyfinn-cursor-bridge-mcp
Wersja: 1.5.4
Licencja: GPL-2.0-or-later
Fork WordPress MCP Adapter 0.5.0 z wbudowanym auto-setupem i diagnostyką dla Cursor IDE.
Łączy WordPress z Cursorem przez MCP — WordPress + baza (wpdb) + pliki przez jeden serwer MCP.
Instrukcja odtworzenia od zera: docs/ODTWORZENIE.md
Co robi ta wtyczka?
| Po aktywacji | Efekt |
|---|---|
| MU-plugin loader | Wtyczka ładuje się nawet po problemach z active_plugins |
| Application Password | Automatyczne hasło „Cursor MCP (Inyfinn)” dla admina |
cursor-setup.json |
Plik konfiguracyjny dla agenta Cursor (SFTP workspace) |
Bundle .env + mcp.json |
DB z wp-config, MCP endpoint, brakujące pola SSH |
| 19 abilities MCP | Ping, manifest, pliki, WooCommerce, health-check, repair |
| Panel diagnostyczny | Ustawienia → Cursor Bridge — testy + przyciski Napraw |
| Hardening | SVG, unikalne nazwy uploadów, /logowanie, limity PHP — z backupem i ochroną przed duplikatami |
Wymagania
| Składnik | Wersja |
|---|---|
| WordPress | 6.8+ (Abilities API) |
| PHP | 7.4+ |
| Cursor IDE | z obsługą MCP |
| Node.js | dla npx @automattic/mcp-wordpress-remote |
| HTTPS | wymagane dla Application Passwords |
Nie instaluj osobnego pluginu mcp-adapter — wtyczka go zastępuje i dezaktywuje konflikt.
Instalacja na nowym WordPressie (5 minut)
Krok 1 — Wgraj wtyczkę
wp-content/plugins/inyfinn-cursor-bridge-mcp/Źródła:
- GitHub Releases: https://github.com/inyfinn/inyfinn-cursor-bridge-mcp/releases
- lub
git clonedoplugins/
Krok 2 — Aktywuj
WP Admin → Wtyczki → Aktywuj „Inyfinn Cursor Bridge MCP”
Auto-setup uruchamia się przy aktywacji (mu-plugin, hasło, setup file).
Krok 3 — Sprawdź diagnostykę
Ustawienia → Cursor Bridge
Wszystkie wiersze w tabeli Diagnostyka powinny być ✓ OK.
Jeśli nie — kliknij Napraw przy danym wierszu lub Pełny auto-setup.
Krok 4 — Cursor workspace
- Zamontuj folder
public_htmlw Cursorze (SFTP / dysk sieciowy). - W chacie Cursora napisz dokładnie:
uruchom wtyczkę inyfinn-cursor-bridge-mcpAgent przeczyta wp-content/inyfinn-cursor-bridge/cursor-setup.json, zapisze .env i mcp.json, zapyta tylko o brakujące pola (SSH, ścieżka workspace).
Krok 5 — Zweryfikuj połączenie MCP
W Cursorze (po skonfigurowaniu MCP):
| Test | Oczekiwany wynik |
|---|---|
cursor-bridge/ping |
ok: true, bridge_version: "1.2.0" |
cursor-bridge/health-check |
healthy: true, failed_count: 0 |
| discover-abilities | ≥19 pozycji cursor-bridge/* |
Szczegóły: docs/INSTALLATION.md
Jak wiedzieć, że działa?
W panelu WordPress
Ustawienia → Cursor Bridge → zielony baner: „Wszystko działa — wtyczka gotowa dla Cursor IDE.”
W Cursorze (po MCP)
Wywołaj cursor-bridge/ping przez MCPOdpowiedź:
{
"ok": true,
"bridge_version": "1.2.0",
"public_abilities": 19
}Przez MCP health-check
Wywołaj cursor-bridge/health-checkOdpowiedź: "healthy": true, "overall": "ok".
Trzy warstwy pracy
| Warstwa | Mechanizm | Kiedy |
|---|---|---|
| Pliki lokalnie | Cursor workspace (SFTP / dysk) | Edycja PHP, CSS, JS — preferowane |
| Pliki zdalnie | MCP write-wp-content-file |
Gdy brak SFTP |
| WordPress / DB | MCP → REST → abilities | Manifest, pluginy, WooCommerce |
| SSH / WP-CLI | Terminal + .env |
Cache, migracje, batch |
Abilities (cursor-bridge/*)
| Ability | Opis |
|---|---|
ping |
Health check wersji |
health-check |
Pełna diagnostyka (12 testów) |
repair |
Naprawa jednego komponentu |
run-auto-setup |
Pełny bootstrap |
get-cursor-bundle |
mcp.json + .env + sekrety (admin) |
get-site-manifest |
Kontekst strony bez sekretów |
write-wp-content-file |
Zapis pliku w wp-content |
read-wp-content-file |
Odczyt pliku (max 512 KB) |
list-plugins / list-themes |
Audyt |
wc-list-products / wc-list-orders |
WooCommerce |
Pełna lista: docs/ABILITIES.md
Naprawa problemów
- Panel WP: Ustawienia → Cursor Bridge → przycisk Napraw przy czerwonym wierszu
- MCP:
cursor-bridge/repairzaction: "full_bootstrap" - Dokumentacja: docs/TROUBLESHOOTING.md
Bezpieczeństwo
cursor-setup.json—chmod 0600, katalog chroniony.htaccess- Odczyt setup file przez MCP zablokowany — sekrety tylko przez
get-cursor-bundle(admin) - Application Password szyfrowane w opcji WP (
AUTH_KEY) - Usuń
cursor-setup.jsonpo pierwszym udanym połączeniu Cursora
Dokumentacja
| Plik | Zawartość |
|---|---|
| docs/ODTWORZENIE.md | Instrukcja odtworzenia od zera (WordPress + baza + pliki) |
| docs/VERIFY.md | Jak sprawdzić, że Cursor ma dostęp |
docs/HARDENING.md |
SVG, uploady, login, limity — zasady bezpieczeństwa |
| docs/INSTALLATION.md | Instalacja krok po kroku |
| docs/TROUBLESHOOTING.md | Rozwiązywanie problemów |
| docs/ABILITIES.md | Reference abilities |
| AGENTS.md | Instrukcja dla agenta Cursor |
| CHANGELOG.md | Historia wersji |
Testy (developers)
wp eval-file wp-content/plugins/inyfinn-cursor-bridge-mcp/tests/smoke-cursor-bridge.phpAutor
Inyfinn — ETA Innovations i projekty WordPress/WooCommerce.
Releases
21 releases. Each count is every asset in that release; expand a row for the breakdown.