WPZylos MCP Server

Intelligent framework-aware context layer for AI-powered WordPress plugin development with WPZylos + WooCommerce support.

55 tools · 12 resources · 9 prompts · 48-hook WooCommerce knowledge base

Quick Start

npm install && npm run build

{
  "mcpServers": {
    "wpzylos": {
      "command": "node",
      "args": ["D:/laragon/www/wpzylos/wpzylos-mcp/dist/index.js"],
      "env": { "WPZYLOS_FRAMEWORK_ROOT": "D:/laragon/www/wpzylos" }
    }
  }
}

Tools (55)

Discovery & Inspection (8)

Tool	Description
set_project_target	Point MCP at a plugin project
list_packages	List all framework packages
inspect_package	Deep-dive into any package
recommend_package	Task-based package recommendation
inspect_file	Analyze any PHP file
search_framework	Search classes/methods across all packages
list_stubs	List code generation templates
get_stub_content	Read a stub template

Code Generation (18)

Tool	Generates
generate_from_stub	Any of 42 stubs
generate_provider	ServiceProvider
generate_model	Model
generate_middleware	Middleware
generate_controller	REST Controller
generate_event	Event
generate_listener	Listener
generate_command	CLI Command
generate_posttype	Custom Post Type
generate_taxonomy	Custom Taxonomy
generate_shortcode	Shortcode
generate_settings	Settings Page
generate_menu	Admin Menu
generate_job	Background Job
generate_rule	Validation Rule
generate_service	Service
generate_migration	Database Migration
generate_test	PHPUnit Test

Validation & Analysis (8)

Tool	Checks
validate_plugin_structure	Folder structure compliance
validate_security_compliance	Nonces, capabilities, escaping, SQL
validate_hook_usage	Hook prefixing
validate_composer_autoload	PSR-4 namespace verification
validate_plugin_header	WordPress plugin header fields
detect_framework_violations	Raw WP functions
detect_incomplete_implementations	TODO/FIXME, empty methods
inspect_conventions	Coding pattern detection

Scaffolding (5)

Tool	Generates
scaffold_plugin	Complete new plugin
scaffold_crud_module	Model + Migration + Controller + Provider + Routes
scaffold_cpt_module	CPT + Taxonomy + MetaBox + Columns + Provider
scaffold_rest_module	Controller + Middleware + Routes + Provider
scaffold_settings_page	Settings + Menu + View + Provider

Inspection & Refactoring (8)

Tool	Purpose
inspect_project_summary	Full plugin inventory
inspect_hook_map	Hook → callback mapping
inspect_dependency_graph	Class dependency analysis
inspect_providers	ServiceProvider inventory
search_in_project	Text search in plugin
suggest_refactoring	Code quality suggestions
explain_boot_sequence	7-phase boot flow
list_all_methods	Flat API reference

WooCommerce Development (8)

Tool	Purpose
woo_search_hooks	Search 48-hook WC knowledge base
woo_scaffold_payment_gateway	WC_Payment_Gateway + process_payment + refund
woo_scaffold_shipping_method	WC_Shipping_Method + calculate_shipping
woo_scaffold_email	WC_Email + trigger + templates
woo_scaffold_widget	WP_Widget + form/update/widget
woo_scaffold_product_tab	Admin or frontend product tab
woo_validate_integration	HPOS, dependency check, deprecations
woo_scaffold_rest_extension	WC REST API v3 controller

Resources (12)

URI	Description
wpzylos://architecture/overview	Framework architecture
wpzylos://architecture/rules	Framework rules
wpzylos://architecture/boot-sequence	7-phase boot flow
wpzylos://architecture/dependency-graph	Package deps
wpzylos://packages/registry	All packages
wpzylos://scaffold/structure	Plugin folder structure
wpzylos://stubs/list	Stub templates
wpzylos://guides/security-checklist	Security checklist
wpzylos://guides/testing	Testing conventions
wpzylos://docs/index	Documentation index
wpzylos://woocommerce/hooks	WC hook reference
wpzylos://woocommerce/dev-guide	WC development guide

Prompts (9)

Prompt	Workflow
create_plugin	New plugin from scratch
audit_plugin	Framework compliance audit
add_feature	Add feature to existing plugin
add_cpt	Add Custom Post Type
add_rest_api	Add REST API endpoints
add_settings_page	Add admin settings page
debug_hook	Debug hook issues
convert_to_framework	Convert traditional plugin
woo_create_extension	Build WooCommerce extension

Architecture

src/
├── core/           (types, cache, config)
├── engine/         (file-analyzer, package-registry, docs-indexer, stub-registry)
├── tools/
│   ├── generation-tools.ts     (16 generators)
│   ├── validation-tools.ts     (6 validators)
│   ├── scaffolding-tools.ts    (6 scaffolders)
│   ├── advanced-tools.ts       (11 advanced tools)
│   └── woocommerce-tools.ts    (8 WooCommerce dev tools)
└── index.ts        (server + 8 core tools + 12 resources + 9 prompts)

License

MIT