WordPress MCP (Model Context Protocol)

A comprehensive Model Context Protocol (MCP) implementation for WordPress, enabling AI models to interact with WordPress sites through a standardized interface.

Features

Content Management

• Full CRUD operations for posts, pages, and custom post types
• Bulk content operations (create, update, delete)
• Advanced content querying with flexible filters
• Special operations (status changes, taxonomy assignments)

Taxonomy Management

• Create, read, update, and delete taxonomies and terms
• Bulk operations for terms
• Advanced term querying and filtering
• Special operations (term merging, hierarchical management)

Media Management

• Upload and manage media attachments
• Support for various media types
• Media metadata handling

User Management

• User CRUD operations
• Role and capability management
• User meta handling

Comments

• Comment CRUD operations
• Comment moderation
• Comment filtering and querying

Menu Management

• Create and manage navigation menus
• Menu item organization
• Menu location assignment

Theme Management

• List and manage themes
• Theme activation
• Theme deletion

Plugin Management

• List installed plugins
• Activate/deactivate plugins
• Plugin removal

Site Settings

• View and update WordPress settings
• Manage site configuration
• Handle date/time settings

Installation

# Install dependencies
bun install

# Start the server
bun start

Configuration

The MCP server requires the following environment variables:

• WORDPRESS_URL: Your WordPress site URL
• WORDPRESS_USERNAME: WordPress admin username
• WORDPRESS_APPLICATION_PASSWORD: WordPress application password

Docker Support

Build the Docker image:

docker build -t wordpress-mcp .

Run the container:

docker run -it wordpress-mcp

Project Structure

src/entities/
├── attachment/     # Media attachment management
├── comment/        # Comment system operations
├── content/        # Post, page, and custom post type handling
├── menu/          # Navigation menu management
├── plugin/        # Plugin management
├── settings/      # WordPress settings management
├── taxonomy/      # Category, tag, and custom taxonomy operations
├── theme/         # Theme management
└── user/          # User management

Each module follows a consistent structure:

• api.ts: API implementation
• schema.ts: JSON Schema definitions
• utils.ts: Helper functions
• index.ts: Module exports

Development

Prerequisites

• Bun 1.x or newer
• WordPress site with REST API enabled
• Application password generated in WordPress

Local Development

# Run in development mode
bun dev

# Run tests
bun test

# Check code style
bun run check

Deployment

This MCP can be deployed using Smithery. Required files are included:

• Dockerfile: Container configuration
• smithery.yaml: Smithery deployment configuration

License

MIT

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request