wordpress-org

This MCP server enables Claude to work with WordPress.org plugin data. It can search WordPress.org plugins by keyword, fetch detailed information for a plugin, download a plugin as a ZIP, extract and inspect its files, list and read individual plugin files, and compare a local plugin against the WordPress.org version. It also provides functionality to generate diffs between plugin versions and view file-level differences. Typical workflows involve searching for plugins of interest, obtaining plugin details, downloading and extracting a plugin, and then comparing your local copy with the official WordPress.org version to identify changes and diffs. The server exposes a set of tools such as search_plugins, get_plugin_info, download_plugin, extract_plugin, list_plugin_files, read_plugin_file, compare_plugins, and get_file_diff to support end-to-end analysis.

Prerequisites:

• Node.js and npm installed on your system.
• Claude CLI installed and authenticated with your workspace (so you can register MCP servers).

Installation steps:

1. Ensure Node.js and npm are installed. For example:
   • macOS/Linux: curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs
   • Windows: install Node.js via https://nodejs.org/
2. Verify npm and node:
   • node -v
   • npm -v
3. Ensure Claude CLI is installed. If needed, install globally (example):
   • npm install -g claude-cli
4. Register the MCP server using the recommended command from the README: claude mcp add wordpress-org npx wordpress-org-mcp-server
5. Verify registration: claude mcp list
6. (Optional) Configure custom cache/extraction directories via environment variables as documented below.

Note: After registration, you can run the MCP server via npx wordpress-org-mcp-server and begin using the available tools through Claude.

Environment variables:

• WP_MCP_CACHE_DIR: Custom directory for downloaded ZIP files
• WP_MCP_EXTRACT_DIR: Custom directory for extracted plugin files

Storage locations:

• The server stores downloads and extractions in system directories by default. You can customize these locations before registration. If you encounter permissions issues or disk space warnings, consider setting WP_MCP_CACHE_DIR and WP_MCP_EXTRACT_DIR to paths with ample space.

Troubleshooting tips:

• "Plugin not found" errors typically mean the plugin slug is incorrect or not available on WordPress.org.
• Download failures may be caused by network issues; check connectivity and WordPress.org availability.
• Extraction errors can result from insufficient permissions or corrupted ZIPs; ensure write permissions and retry.

Supported file types for diffing and inspection include PHP, JS, CSS, text/config files; binary files are compared by size only when diffing.