MCP 服务器

wp-cli-mcp

MCP server that gives AI tools full WordPress management via WP-CLI. 30+ tools for themes, plugins, posts, menus, users, database, scaffolding, and cache. Works locally or over SSH.

README

wp-cli-mcp

MCP server that gives AI tools full WordPress management via WP-CLI. Themes, plugins, posts, menus, users, database, scaffolding — 45+ tools.

What can Claude do with this?

"Install WooCommerce and activate it"
"Create a new page called About Us with this content..."
"List all plugins and deactivate the ones I'm not using"
"Scaffold a new child theme called my-theme"
"Create a navigation menu with Home, About, Contact links"
"Search and replace old domain with new domain in database"
"Export the database before I make changes"
"Generate a custom Gutenberg block for testimonials"

All powered by WP-CLI under the hood. Works locally or over SSH to remote servers.

Tools (30+)

Category	Tools
Core	`wp_core_version`, `wp_core_check_update`
Plugins	`wp_plugin_list`, `wp_plugin_install`, `wp_plugin_activate`, `wp_plugin_deactivate`, `wp_plugin_delete`, `wp_plugin_search`
Themes	`wp_theme_list`, `wp_theme_install`, `wp_theme_activate`, `wp_theme_delete`
Theme Files	`wp_theme_file_list`, `wp_theme_file_read`, `wp_theme_file_write`, `wp_theme_file_delete`
Posts	`wp_post_list`, `wp_post_get`, `wp_post_create`, `wp_post_update`, `wp_post_delete`
Post Meta	`wp_post_meta_get`, `wp_post_meta_update`, `wp_post_meta_list`
Taxonomies	`wp_term_list`, `wp_term_create`
Users	`wp_user_list`, `wp_user_create`
Options	`wp_option_get`, `wp_option_update`
Menus	`wp_menu_list`, `wp_menu_create`, `wp_menu_item_add`, `wp_menu_location_assign`
Widgets	`wp_sidebar_list`, `wp_widget_list`
Media	`wp_media_import`
Database	`wp_db_query`, `wp_db_export`, `wp_search_replace`
Scaffold	`wp_scaffold_theme`, `wp_scaffold_plugin`, `wp_scaffold_block`
Cache	`wp_rewrite_flush`, `wp_cache_flush`
PHP	`wp_eval` — execute any PHP in WordPress context
Site	`wp_site_info` — full site overview
Raw	`wp_cli_raw` — run any WP-CLI command

Requirements

WP-CLI installed and in PATH
WordPress installation (local or accessible via SSH)
Node.js 18+

Setup

Install

npm install -g wp-cli-mcp

Configure with Claude Code

Add to your Claude Code MCP settings (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "wordpress": {
      "command": "wp-cli-mcp",
      "env": {
        "WP_PATH": "/path/to/your/wordpress"
      }
    }
  }
}

Remote server via SSH

{
  "mcpServers": {
    "wordpress": {
      "command": "wp-cli-mcp",
      "env": {
        "WP_SSH": "user@yourserver.com:/var/www/html"
      }
    }
  }
}

Environment Variables

Variable	Description	Example
`WP_PATH`	Local WordPress path	`/var/www/html`
`WP_SSH`	SSH connection string	`user@host:/path/to/wp`
`WP_URL`	Site URL (multisite)	`https://example.com`

Examples

Theme Development Workflow

You: "Scaffold a child theme based on twentytwentyfour"
Claude: Uses wp_scaffold_theme → creates child theme files

You: "Install and activate it"
Claude: Uses wp_theme_activate → theme is live

You: "Create the homepage with a hero section and 3 feature cards"
Claude: Uses wp_post_create → creates page with HTML content

Plugin Management

You: "What plugins do I have installed?"
Claude: Uses wp_plugin_list → shows all plugins with status

You: "Install Contact Form 7 and WooCommerce"
Claude: Uses wp_plugin_install twice → both installed and activated

Database Operations

You: "I'm migrating from staging.example.com to example.com"
Claude: Uses wp_db_export → backup first
       Uses wp_search_replace (dry_run) → preview changes
       Uses wp_search_replace → apply changes
       Uses wp_cache_flush → clear cache