WP MCP Server Demo

A lightweight WordPress plugin that configures a custom Model Context Protocol (MCP) server using the WordPress MCP Adapter and Abilities API. This plugin acts as a configuration wrapper that creates an MCP server exposing abilities defined in the WP Abilities API Demo plugin.

Overview

This plugin serves as a thin configuration layer that:

• Initializes the WordPress MCP Adapter
• Creates a custom MCP server named "MCP Demo Server"
• Exposes specific abilities from the WP Abilities API Demo plugin as MCP tools
• Demonstrates how to configure a custom MCP server in WordPress

How It Works

This plugin does not define any abilities itself. Instead, it:

1. Checks for required plugins - Verifies that MCP Adapter and WP Abilities API Demo plugins are active
2. Initializes MCP Adapter - Activates the MCP Adapter framework
3. Creates a custom MCP server - Configures a server named "MCP Demo Server"
4. Maps abilities to the server - Links abilities from WP Abilities API Demo plugin to the MCP server

MCP Tools Available

The following abilities from the WP Abilities API Demo plugin are exposed through this MCP server:

• Site Info (site/site-info) - Retrieve comprehensive WordPress site information
• Debug Log Management (debug/read-log, debug/clear-log) - Read and clear WordPress debug logs
• Plugin List (plugins/get-plugins) - Retrieve a list of installed WordPress plugins
• Create Post (post/create-post) - Create new WordPress blog posts
• Security Check (security/check-security) - Perform security analysis on WordPress plugins

Note: The actual implementation of these abilities is in the WP Abilities API Demo plugin, not in this repository.

Architecture

• Server Configuration: Lightweight wrapper that configures an MCP server
• Abilities Source: All abilities are defined in the WP Abilities API Demo plugin
• Transport: REST API-based HTTP communication (MCP 2025-06-18 compliant)
• Error Handling: WordPress error logging integration
• Observability: Null handler for minimal overhead

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• Required WordPress Plugins:
  • MCP Adapter - Core MCP functionality
  • WP Abilities API Demo - Provides the actual abilities

Installation

1. Install Required Plugins

First, install and activate the required plugins:

# Clone and activate MCP Adapter
cd wp-content/plugins/
git clone https://github.com/WordPress/mcp-adapter.git
wp plugin activate mcp-adapter

# Clone and activate WP Abilities API Demo
git clone https://github.com/jonathanbossenger/wp-abilities-api-demo.git
cd wp-abilities-api-demo
composer install
wp plugin activate wp-abilities-api-demo

2. Install This Plugin

Clone this repository and activate it:

cd wp-content/plugins/
git clone https://github.com/jonathanbossenger/wp-mcp-server-demo.git
wp plugin activate wp-mcp-server-demo

Note: This plugin does not require composer install as it has no Composer dependencies of its own. It only requires WPCS for development.

API Endpoints

Once activated, the plugin exposes MCP endpoints at:

/wp-json/mcp-demo-server/mcp/

MCP Connection

{
  "mcpServers": {
    "mcp-demo-server": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"
      ],
      "env": {
        "WP_API_URL": "http://your-site.test/wp-json/mcp-demo-server/mcp",
        "LOG_FILE": "/path/to/logs/mcp-adapter.log",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "your-application-password"
      }
    }
  }
}

Available Tools

The following tools are available through the MCP

... View full README on GitHub