# 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

```bash
npm install && npm run build
```

```json
{
  "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