JSPM

  • Created
  • Published
  • Downloads 501
  • Score
    100M100P100Q84877F
  • License MIT

Comprehensive Model Context Protocol server for WordPress management with 59 tools, performance monitoring, intelligent caching, auto-generated documentation, Docker support, TypeScript, and production-ready authentication

Package Exports

  • mcp-wordpress
  • mcp-wordpress/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (mcp-wordpress) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

MCP WordPress Server

WordPress MCP Logo

A comprehensive Model Context Protocol (MCP) server for WordPress management through Claude Desktop. Manage your WordPress sites with natural language through 59 powerful tools.

NPM Version Test Coverage TypeScript

โšก Quick Start

Choose your setup method:

  • ๐Ÿš€ NPX Setup - Zero installation, always latest (Recommended)
  • ๐Ÿ’ป NPM Setup - Local development
  • ๐Ÿณ Docker Setup - Containerized deployment
  • ๐Ÿ“ฆ DTX Setup - Claude Desktop Extension

Ultra-Quick Start (NPX)

# Run directly with NPX (recommended)
npx -y mcp-wordpress

# Follow the setup wizard
npm run setup

Setup takes 2 minutes - the wizard guides you through WordPress connection and Claude Desktop configuration.

๐Ÿš€ Features

WordPress Management

  • 59 WordPress Tools - Posts, pages, media, users, comments, categories, tags, site settings
  • Multi-Site Support - Manage multiple WordPress sites from one configuration
  • Flexible Authentication - App Passwords (recommended), JWT, Basic Auth, API Key

Performance & Monitoring

  • โšก Intelligent Caching - 50-70% performance improvement with multi-layer caching
  • ๐Ÿ“Š Real-Time Monitoring - Performance metrics, analytics, and optimization insights
  • ๐Ÿ”’ Production Ready - Security-reviewed, 95%+ test coverage, battle-tested

Developer Experience

  • 100% TypeScript - Complete type safety and IntelliSense
  • ๐Ÿณ Docker Support - Containerized deployment for production
  • ๐Ÿ“š Auto-Generated Docs - Complete API documentation with examples
  • ๐Ÿ”„ 100% Backward Compatible - Zero breaking changes

๐ŸŒ Multi-Site Configuration

Perfect for agencies and developers managing multiple WordPress sites:

{
  "sites": [
    {
      "id": "main-site",
      "name": "Main WordPress Site",
      "config": {
        "WORDPRESS_SITE_URL": "https://site1.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    },
    {
      "id": "client-blog",
      "name": "Client Blog",
      "config": {
        "WORDPRESS_SITE_URL": "https://client-blog.com",
        "WORDPRESS_USERNAME": "editor",
        "WORDPRESS_APP_PASSWORD": "yyyy yyyy yyyy yyyy yyyy yyyy"
      }
    }
  ]
}

Use with site parameter: wp_list_posts --site="main-site"

๐Ÿ“– Complete Multi-Site Setup Guide

๐Ÿ” Authentication Setup

  1. WordPress Admin โ†’ Users โ†’ Profile
  2. Scroll to Application Passwords
  3. Enter name: "MCP WordPress Server"
  4. Click Add New Application Password
  5. Copy the generated password

Alternative Methods

  • JWT Authentication - With JWT plugin
  • Basic Authentication - Username/password (dev only)
  • API Key Authentication - With API Key plugin

๐Ÿ“– Complete Authentication Guide

๐Ÿ“‹ Available Tools (59 Tools)

Content Management

  • ๐Ÿ“ Posts (6 tools) - Create, edit, delete, list posts and revisions
  • ๐Ÿ“„ Pages (6 tools) - Manage static pages and revisions
  • ๐Ÿ–ผ๏ธ Media (6 tools) - Upload, manage media library and files

User & Community

  • ๐Ÿ‘ฅ Users (6 tools) - User management and profiles
  • ๐Ÿ’ฌ Comments (7 tools) - Comment moderation and management
  • ๐Ÿท๏ธ Taxonomies (10 tools) - Categories and tags management

Site Management

  • โš™๏ธ Site Settings (7 tools) - Site configuration and statistics
  • ๐Ÿ” Authentication (6 tools) - Auth testing and management
  • โšก Cache Management (4 tools) - Performance caching control
  • ๐Ÿ“Š Performance Monitoring (6 tools) - Real-time metrics and optimization

๐Ÿ“– Complete Tool Documentation

๐Ÿค– Claude Desktop Integration

Quick Prompts for Claude

Setup Help:

Set up MCP WordPress using NPX. My site: https://mysite.com, username: myuser. Help with application password creation and Claude Desktop configuration.

Content Management:

List my recent WordPress posts, then help me create a new post about [topic] with SEO-optimized content.

Site Analysis:

Check my WordPress site performance, cache statistics, and provide optimization recommendations.

Configuration Example

{
  "mcpServers": {
    "mcp-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-wordpress"],
      "env": {
        "WORDPRESS_SITE_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

๐Ÿ“– Complete Claude Desktop Setup

๐Ÿงช Testing & Status

Current Test Status โœ…

  • Main Test Suite: 207/207 passed (100%)
  • Security Tests: 40/40 passed (100%)
  • Performance Tests: 8/8 passed (100%)
  • CI/CD Pipeline: Fully functional

Test Your Installation

# Check connection status
npm run status

# Run full test suite
npm test

# Quick validation
npm run test:fast

๐Ÿ› Troubleshooting

Common Issues

  1. "Cannot connect to WordPress"

    • Verify WORDPRESS_SITE_URL
    • Test REST API: curl https://your-site.com/wp-json/wp/v2/
  2. "Authentication failed"

    • Check username and application password
    • Ensure Application Passwords are enabled
    • Run npm run setup to reconfigure
  3. "Tools not appearing in Claude"

    • Restart Claude Desktop after configuration
    • Check Claude Desktop config file format

Get Help

# Debug mode
DEBUG=true npm run dev

# Connection test
npm run status

# Re-run setup wizard
npm run setup

๐Ÿ“š Documentation

User Guides

Technical Documentation

Developer Resources

๐Ÿ”ง Requirements

  • WordPress 5.0+ with REST API enabled
  • HTTPS recommended for production
  • User with appropriate permissions
  • Application Passwords enabled (WordPress 5.6+)

WordPress User Roles

Role Access
Administrator Full access to all functions
Editor Posts, pages, comments, media
Author Own posts and media
Contributor Own posts (drafts only)
Subscriber Read only

๐Ÿ“ฆ Installation Options

NPM Package

# Global installation
npm install -g mcp-wordpress

# Direct usage (recommended)
npx -y mcp-wordpress

Docker Images

# Latest version
docker pull docdyhr/mcp-wordpress:latest

# Specific version
docker pull docdyhr/mcp-wordpress:1.3.1

Distribution Channels

๐Ÿ™ Acknowledgments

Special thanks to Stephan Ferraro for the upstream project that inspired this implementation.


Ready to get started? Choose your setup method above and follow the guide - you'll be managing WordPress with Claude in minutes! ๐Ÿš€