内容
# WordPress Boost
借助人工智能提供深度洞察、安全性审计和智能代码生成，加速您的WordPress开发。
灵感来自 [Laravel Boost](https://laravel.com/docs/12.x/boost)。
## 概述
WordPress Boost 通过提供关于WordPress代码库的深入上下文、全面安全性审计、测试数据生成和精选的人工智能指南，加速人工智能辅助开发。可与任何人工智能代理（Claude Code、Cursor、Windsurf等）配合使用。
- 钩子（动作和过滤器）及其回调函数
- 数据库模式和查询
- 文章类型、分类法和REST端点
- 安全漏洞和站点强化状态
- ACF字段组和WooCommerce配置
- 测试数据生成
- 以及更多...
## 主要功能
### 🔍 深度WordPress洞察
30多种专项工具，用于扫描钩子、文章类型、分类法、REST端点、数据库模式等 - 为人工智能代理提供准确代码生成所需的上下文。
### 🛡️ 安全审计
全面的安全分析，包括代码漏洞扫描（SQL注入、XSS等）和站点级审计，检查配置、更新、权限和头部 - 配备A-F评分。
### 📝 人工智能指南和技能
预建的指南和技能安装到项目的`.ai/`目录中，教导人工智能助手WordPress主题、插件、REST API、Gutenberg、ACF和WooCommerce的最佳实践。
### 🧪 测试数据生成
使用Faker生成逼真的测试文章、页面、用户、分类法术语、WooCommerce产品和ACF字段数据 - 适用于开发和测试。
### ⚡ 开发工具
在WordPress上下文中执行PHP代码（wp_shell），运行数据库查询，搜索文档，读取错误日志 - 所有这些都可供您的人工智能助手访问。
## 安装
### 使用Composer（推荐）
```bash
cd /path/to/wordpress
composer require thanoseleftherakos/wordpress-boost --dev
php vendor/bin/wp-boost --init
```
就这样！`--init`标志创建了一个`.mcp.json`文件，并将人工智能指南和技能安装到`.ai/`目录中。
### CLI选项
```bash
php vendor/bin/wp-boost --init # 完整设置：.mcp.json + AI文件
php vendor/bin/wp-boost --init --no-ai-files # 仅创建.mcp.json配置文件
php vendor/bin/wp-boost --guidelines-only # 仅安装AI指南到.ai/guidelines/
php vendor/bin/wp-boost --skills-only # 仅安装AI技能到.ai/skills/
php vendor/bin/wp-boost --version # 显示版本
php vendor/bin/wp-boost --help # 显示帮助
```
### 不使用Composer
对于不使用Composer的WordPress项目：
```bash
# 克隆到WordPress项目外部的位置
git clone https://github.com/thanoseleftherakos/wordpress-boost.git ~/wordpress-boost
cd ~/wordpress-boost
composer install
# 在WordPress项目中初始化
cd /path/to/wordpress
php ~/wordpress-boost/bin/wp-boost --init
```
然后编辑`.mcp.json`以使用绝对路径：
```json
{
"servers": {
"wordpress-boost": {
"command": "php",
"args": ["/Users/YOUR_USERNAME/wordpress-boost/bin/wp-boost"]
}
}
}
```
## 快速入门
### 适用于Cursor / VS Code / Windsurf
这些编辑器会自动检测`.mcp.json`文件。运行`--init`后，只需打开您的WordPress项目，MCP服务器将自动可用。
### 适用于Claude Code
```bash
cd /path/to/wordpress
claude mcp add wordpress-boost -- php vendor/bin/wp-boost
```
不需要`--path` - WordPress Boost从当前目录自动发现您的WordPress安装。
## 人工智能指南和技能
WordPress Boost包含精选的人工智能指南和技能，帮助人工智能助手编写更好的WordPress代码。这些指南和技能安装到项目的`.ai/`目录中。
### 指南（`.ai/guidelines/`）
- `wordpress-core.md` - 核心WordPress模式和最佳实践
- `theme-development.md` - 主题开发标准
- `plugin-development.md` - 插件开发模式
- `rest-api.md` - REST API开发
- `gutenberg-blocks.md` - 块编辑器开发
- `security.md` - WordPress安全实践
- `acf.md` - 高级自定义字段模式
- `woocommerce.md` - WooCommerce开发
### 技能（`.ai/skills/`）
- `theme-development` - 主题创建和自定义
- `plugin-development` - 插件架构和钩子
- `rest-api-development` - 自定义REST端点
- `gutenberg-blocks` - 自定义块开发
- `acf-development` - ACF字段组和使用
- `woocommerce-development` - WooCommerce扩展
- `wp-cli-commands` - WP-CLI命令创建
## 可用工具
### 站点信息
| 工具 | 描述 |
|------|-------------|
| `site_info` | WordPress版本、PHP版本、活动主题、插件、调试设置 |
| `list_plugins` | 所有已安装插件，版本和状态 |
| `list_themes` | 可用主题，父/子关系 |
### 钩子洞察
| 工具 | 描述 |
|------|-------------|
| `list_hooks` | 所有已注册的动作和过滤器 |
| `get_hook_callbacks` | 附加到钩子的回调函数，优先级 |
| `search_hooks` | 按模式搜索钩子 |
### WordPress结构
| 工具 | 描述 |
|------|-------------|
| `list_post_types` | 已注册的文章类型，配置 |
| `list_taxonomies` | 已注册的分类法 |
| `list_shortcodes` | 已注册的短代码 |
| `list_rest_endpoints` | WP REST API路由 |
| `list_rewrite_rules` | URL重写规则 |
| `list_cron_events` | 调度的WP-Cron任务 |
| `template_hierarchy` | 模板解析信息 |
### 数据库工具
| 工具 | 描述 |
|------|-------------|
| `database_schema` | 表结构（核心+插件表） |
| `database_query` | 通过$wpdb执行SELECT查询 |
| `get_option` | 读取wp_options值 |
| `list_options` | 列出可用选项 |
### 开发上下文
| 工具 | 描述 |
|------|-------------|
| `search_docs` | 搜索WordPress开发者文档 |
| `wp_shell` | 在WordPress上下文中执行PHP代码 |
| `last_error` | 读取debug.log条目 |
| `list_wp_cli_commands` | 可用的WP-CLI命令 |
### URL和环境
| 工具 | 描述 |
|------|-------------|
| `urls` | 获取所有WordPress URL（首页，站点，管理后台，REST，内容等） |
| `environment` | 服务器环境信息（PHP，MySQL，扩展，内存限制） |
### 安全工具
| 工具 | 描述 |
|------|-------------|
| `site_security_audit` | 全面的站点安全审计，评分（信息披露，XML-RPC，登录安全，配置，更新，权限，头部） |
| `security_audit` | 扫描文件/目录的代码漏洞（SQL注入，XSS等） |
| `security_check_file` | 检查特定文件的安全问题，带有行号 |
| `list_security_functions` | 按类别列出WordPress安全函数（净化， escaping，非ces等） |
### WordPress能力API（WordPress 6.9+）
| 工具 | 描述 |
|------|-------------|
| `abilities_status` | 能力API可用性，已注册能力计数，插件命名空间，MCP适配器状态 |
| `list_abilities` | 列出已注册的能力，类别/命名空间/搜索筛选 |
| `get_ability` | 详细的能力信息，包括输入/输出JSON模式和注释 |
| `list_ability_categories` | 能力类别，描述和计数 |
### ACF集成（当ACF激活时）
| 工具 | 描述 |
|------|-------------|
| `list_acf_field_groups` | 所有已注册的字段组（包括AI访问和Schema.org元数据，适用于ACF 6.8+） |
| `list_acf_fields` | 字段组中的字段（包括Schema.org属性映射，适用于ACF 6.8+） |
| `get_acf_schema` | 用于代码生成的完整ACF结构 |
| `get_acf_field` | 详细的字段信息，带有用法示例 |
| `get_acf_ai_status` | ACF 6.8+ AI访问状态，Schema.org配置和已注册能力概述 |
### WooCommerce集成（当WooCommerce激活时）
| 工具 | 描述 |
|------|-------------|
| `woo_info` | WooCommerce版本和设置 |
| `list_product_types` | 已注册的产品类型 |
| `woo_schema` | WooCommerce表结构 |
| `list_payment_gateways` | 支付网关配置 |
| `list_shipping_methods` | 运输方式配置 |
### Gutenberg块
| 工具 | 描述 |
|------|-------------|
| `list_block_types` | 已注册的块类型 |
| `list_block_patterns` | 已注册的块模式 |
| `list_block_categories` | 块类别 |
### 数据生成（需要fakerphp/faker）
| 工具 | 描述 |
|------|-------------|
| `create_posts` | 生成测试文章 |
| `create_pages` | 生成测试页面 |
| `create_users` | 生成测试用户 |
| `create_terms` | 生成分类法术语 |
| `create_products` | 生成WooCommerce产品 |
| `populate_acf` | 用测试数据填充ACF字段 |
## 安全
### wp_shell安全
`wp_shell`工具仅在启用`WP_DEBUG`时工作。它还防止危险操作：
- 没有`exec`、`shell_exec`、`system`或类似函数
- 没有文件写入操作
- 没有`eval`或`create_function`
### 数据库安全
- 仅允许通过`database_query`执行`SELECT`查询
- 所有查询内部使用`$wpdb->prepare()`
- 结果限制以防止内存问题
## 要求
- PHP 7.4或更高
- WordPress 5.0或更高
- Composer（用于安装）
## 可选依赖
- `fakerphp/faker` - 用于数据生成工具
## 开发
### 运行测试
```bash
composer test
```
### 代码风格
```bash
composer cs-fix
```
## 工作原理
```
1. 人工智能代理（Claude Code，Cursor等）
↓
2. MCP协议（JSON-RPC over stdio）
↓
3. WordPress Boost服务器
↓
4. WordPress引导（wp-load.php）
↓
5. WordPress函数和数据
```
WordPress Boost在CLI模式下加载WordPress，提供对所有WordPress函数、钩子和数据的完全访问，同时通过MCP协议与人工智能代理通信。
## 许可证
MIT许可证 - 有关详细信息，请参见LICENSE文件。
## 致谢
- 为 [Model Context Protocol](https://modelcontextprotocol.io/) 构建
