{"id":30872099,"url":"https://github.com/docdyhr/mcp-wordpress","last_synced_at":"2026-04-30T03:03:17.237Z","repository":{"id":301432141,"uuid":"1008346345","full_name":"docdyhr/mcp-wordpress","owner":"docdyhr","description":"MCP Server to manage a Wordpress CMS system.","archived":false,"fork":false,"pushed_at":"2026-03-26T09:06:07.000Z","size":14603,"stargazers_count":76,"open_issues_count":0,"forks_count":11,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-27T02:57:35.773Z","etag":null,"topics":["claude-ai","cms","mcp","typescript","wordpress"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"AiondaDotCom/mcp-wordpress","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/docdyhr.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"docdyhr"}},"created_at":"2025-06-25T12:00:39.000Z","updated_at":"2026-03-26T09:10:37.000Z","dependencies_parsed_at":"2025-07-14T14:09:04.862Z","dependency_job_id":"2f4396aa-97fd-43b1-ba8e-a158733975fd","html_url":"https://github.com/docdyhr/mcp-wordpress","commit_stats":null,"previous_names":["docdyhr/mcp-wordpress"],"tags_count":90,"template":false,"template_full_name":null,"purl":"pkg:github/docdyhr/mcp-wordpress","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docdyhr%2Fmcp-wordpress","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docdyhr%2Fmcp-wordpress/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docdyhr%2Fmcp-wordpress/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docdyhr%2Fmcp-wordpress/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/docdyhr","download_url":"https://codeload.github.com/docdyhr/mcp-wordpress/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docdyhr%2Fmcp-wordpress/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31315942,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-ai","cms","mcp","typescript","wordpress"],"created_at":"2025-09-07T22:05:46.172Z","updated_at":"2026-04-02T20:27:15.339Z","avatar_url":"https://github.com/docdyhr.png","language":"JavaScript","funding_links":["https://github.com/sponsors/docdyhr"],"categories":["Other"],"sub_categories":[],"readme":"# 🚀 MCP WordPress Server\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"images/wordpress-mcp-logo.png\" width=\"50%\" alt=\"WordPress MCP Logo\"\u003e\n\n**The Most Comprehensive WordPress MCP Server**\n\nManage WordPress sites with natural language through AI tools like Claude Desktop\n\n[Quick Start](#-quick-start) • [Why This MCP Server?](#-why-this-mcp-server)\n[Installation Options](#-installation-options) • [Documentation](#-documentation) • [Examples](#-examples)\n\n[![CI/CD Pipeline](https://github.com/docdyhr/mcp-wordpress/actions/workflows/main-ci.yml/badge.svg)](https://github.com/docdyhr/mcp-wordpress/actions/workflows/main-ci.yml)\n[![GitHub Stars](https://img.shields.io/github/stars/docdyhr/mcp-wordpress?style=social)](https://github.com/docdyhr/mcp-wordpress/stargazers)\n[![NPM Version](https://img.shields.io/npm/v/mcp-wordpress?logo=npm\u0026logoColor=white)](https://www.npmjs.com/package/mcp-wordpress)\n[![NPM Downloads](https://img.shields.io/npm/dm/mcp-wordpress?logo=npm\u0026logoColor=white)](https://www.npmjs.com/package/mcp-wordpress)\n[![NPM Total Downloads](https://img.shields.io/npm/dt/mcp-wordpress?logo=npm\u0026logoColor=white\u0026label=total%20downloads)](https://www.npmjs.com/package/mcp-wordpress)\n[![Docker Pulls](https://img.shields.io/docker/pulls/docdyhr/mcp-wordpress?logo=docker\u0026logoColor=white)](https://hub.docker.com/r/docdyhr/mcp-wordpress)\n[![Coverage Status](https://img.shields.io/codecov/c/github/docdyhr/mcp-wordpress?logo=codecov\u0026logoColor=white)](https://codecov.io/gh/docdyhr/mcp-wordpress)\n[![MCP Evaluation](https://img.shields.io/badge/mcp%20evaluation-4.5%2F5.0-brightgreen?logo=openai\u0026logoColor=white)](https://github.com/docdyhr/mcp-wordpress/actions/workflows/mcp-evaluations.yml)\n\n[![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue?logo=typescript\u0026logoColor=white)](https://github.com/docdyhr/mcp-wordpress)\n[![CodeQL](https://github.com/docdyhr/mcp-wordpress/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/docdyhr/mcp-wordpress/actions/workflows/codeql-analysis.yml)\n[![Quality Assurance](https://github.com/docdyhr/mcp-wordpress/actions/workflows/quality-assurance.yml/badge.svg)](https://github.com/docdyhr/mcp-wordpress/actions/workflows/quality-assurance.yml)\n[![Security Monitoring](https://github.com/docdyhr/mcp-wordpress/actions/workflows/security-monitoring.yml/badge.svg)](https://github.com/docdyhr/mcp-wordpress/actions/workflows/security-monitoring.yml)\n[![Docker](https://img.shields.io/badge/docker-ready-blue?logo=docker\u0026logoColor=white)](https://hub.docker.com/r/docdyhr/mcp-wordpress)\n[![License](https://img.shields.io/badge/license-MIT-green?logo=opensource\u0026logoColor=white)](https://github.com/docdyhr/mcp-wordpress/blob/main/LICENSE)\n\u003c!-- Badges updated: 2025-12-23 --\u003e\n### 🎉 **v2.12.0** - Modular Architecture \u0026 Fault Tolerance!\n\n\u003c/div\u003e\n\n## 🎯 Why This MCP Server?\n\n**Transform WordPress management** from complex admin panels to simple conversations:\n\n```text\n❌ Before: Login → Admin Panel → Navigate → Click → Fill Forms → Save\n✅ After:  \"Create a new blog post about AI trends with SEO optimization\"\n```\n\n**Key Advantages:**\n\n- 🏆 **Most Complete**: 59 tools vs 20-30 in alternatives\n- ⚡ **Fastest Setup**: 2-click Claude Desktop installation via DXT\n- 🔒 **Production Ready**: 2200+ tests, security audited, battle-tested\n- 🎯 **TypeScript Native**: 100% type safety, best-in-class developer experience\n- 🌐 **Multi-Site**: Manage unlimited WordPress sites from one place\n\n## 🚀 Quick Start\n\nGet up and running in **under 5 minutes**:\n\n### Prerequisites\n\n- **WordPress**: Version 5.6+ with REST API enabled\n- **Claude Desktop**: Latest version installed\n- **Application Password**: Generated from WordPress admin panel\n\n### 3-Step Setup\n\n**1️⃣ Generate WordPress Application Password**\n\n```text\nWordPress Admin → Users → Profile → Application Passwords → Add New\n```\n\n**2️⃣ Install MCP Server (Choose One)**\n\n**Option A: DXT Extension (Easiest)**\n\n```bash\n# Download and install in Claude Desktop\ncurl -L https://github.com/docdyhr/mcp-wordpress/releases/latest/download/mcp-wordpress.dxt -o mcp-wordpress.dxt\n# Then: Claude Desktop → Extensions → Install → Select DXT file\n```\n\n**Option B: NPM Global Install**\n\n```bash\nnpm install -g mcp-wordpress\n```\n\n**3️⃣ Test Your Connection**\n\n```text\nIn Claude: \"Test my WordPress connection\"\nResponse: \"✅ Authentication successful! Connected to: Your Site Name\"\n```\n\n📺 **[Watch 2-minute Setup Video](https://github.com/docdyhr/mcp-wordpress/wiki/setup-video)** | 📖\n**[Detailed Setup Guide](docs/INSTALLATION.md)**\n\n## ⚡ Installation Options\n\n### 🏆 Recommended: Claude Desktop Extension (DXT)\n\n**Easiest installation - just 2 clicks!**\n\n1. **Download**:\n   [`mcp-wordpress.dxt`](https://github.com/docdyhr/mcp-wordpress/releases/latest/download/mcp-wordpress.dxt) (3.4MB)\n2. **Install**: Claude Desktop → Extensions → Install → Select DXT file\n3. **Configure**: Enter your WordPress site URL and credentials\n\n✅ **Zero command line required** ✅ **Easy updates** ✅ **Built-in security**\n\n**[📖 Complete DXT Setup Guide →](docs/integrations/claude-desktop.md)**\n\n### 🚀 Alternative: NPX (Power Users)\n\n```bash\n# Run directly - always latest version\nnpx -y mcp-wordpress\n\n# Interactive setup wizard\nnpm run setup\n```\n\n### 🔧 Other Options\n\n- 💻 **[NPM Setup](docs/user-guides/NPM_SETUP.md)** - Local development\n- 🐳 **[Docker Setup](docs/user-guides/DOCKER_SETUP.md)** - Production deployment\n- 🔧 **[Manual Build](docs/developer/BUILD_SYSTEM.md)** - Custom builds\n\n## 📋 Configuration Examples\n\n### Single Site Setup\n\n**Environment Variables (.env)**\n\n```bash\nWORDPRESS_SITE_URL=https://myblog.com\nWORDPRESS_USERNAME=admin\nWORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx\nWORDPRESS_AUTH_METHOD=app-password\n```\n\n**Claude Desktop Config**\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-wordpress\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-wordpress\"],\n      \"env\": {\n        \"WORDPRESS_SITE_URL\": \"https://myblog.com\",\n        \"WORDPRESS_USERNAME\": \"admin\",\n        \"WORDPRESS_APP_PASSWORD\": \"xxxx xxxx xxxx xxxx xxxx xxxx\"\n      }\n    }\n  }\n}\n```\n\n### Multi-Site Agency Setup\n\n**Configuration File (mcp-wordpress.config.json)**\n\n```json\n{\n  \"sites\": [\n    {\n      \"id\": \"main-corporate\",\n      \"name\": \"Corporate Website\",\n      \"config\": {\n        \"WORDPRESS_SITE_URL\": \"https://company.com\",\n        \"WORDPRESS_USERNAME\": \"admin\",\n        \"WORDPRESS_APP_PASSWORD\": \"xxxx xxxx xxxx xxxx xxxx xxxx\",\n        \"WORDPRESS_AUTH_METHOD\": \"app-password\"\n      }\n    },\n    {\n      \"id\": \"client-restaurant\",\n      \"name\": \"Restaurant Client\",\n      \"config\": {\n        \"WORDPRESS_SITE_URL\": \"https://bestrestaurant.com\",\n        \"WORDPRESS_USERNAME\": \"editor\",\n        \"WORDPRESS_APP_PASSWORD\": \"yyyy yyyy yyyy yyyy yyyy yyyy\",\n        \"WORDPRESS_AUTH_METHOD\": \"app-password\"\n      }\n    },\n    {\n      \"id\": \"client-ecommerce\",\n      \"name\": \"E-commerce Client\",\n      \"config\": {\n        \"WORDPRESS_SITE_URL\": \"https://onlinestore.com\",\n        \"WORDPRESS_USERNAME\": \"shopmanager\",\n        \"WORDPRESS_APP_PASSWORD\": \"zzzz zzzz zzzz zzzz zzzz zzzz\",\n        \"WORDPRESS_AUTH_METHOD\": \"app-password\"\n      }\n    }\n  ]\n}\n```\n\n### Development Environment\n\n**Local WordPress with Docker**\n\n```yaml\n# docker-compose.yml\nversion: \"3.8\"\nservices:\n  wordpress:\n    image: wordpress:latest\n    ports:\n      - \"8080:80\"\n    environment:\n      WORDPRESS_DB_HOST: db\n      WORDPRESS_DB_USER: wordpress\n      WORDPRESS_DB_PASSWORD: wordpress\n      WORDPRESS_DB_NAME: wordpress\n    volumes:\n      - wordpress_data:/var/www/html\n\n  db:\n    image: mysql:8.0\n    environment:\n      MYSQL_DATABASE: wordpress\n      MYSQL_USER: wordpress\n      MYSQL_PASSWORD: wordpress\n      MYSQL_ROOT_PASSWORD: rootpassword\n    volumes:\n      - db_data:/var/lib/mysql\n\nvolumes:\n  wordpress_data:\n  db_data:\n```\n\n**MCP WordPress Development Config**\n\n```json\n{\n  \"sites\": [\n    {\n      \"id\": \"local-dev\",\n      \"name\": \"Local Development\",\n      \"config\": {\n        \"WORDPRESS_SITE_URL\": \"http://localhost:8080\",\n        \"WORDPRESS_USERNAME\": \"admin\",\n        \"WORDPRESS_APP_PASSWORD\": \"dev-password-here\",\n        \"WORDPRESS_AUTH_METHOD\": \"app-password\"\n      }\n    }\n  ]\n}\n```\n\n### Production Deployment\n\n**Server Environment Variables**\n\n```bash\n# /etc/environment or systemd service\nWORDPRESS_SITE_URL=https://production-site.com\nWORDPRESS_USERNAME=api-user\nWORDPRESS_APP_PASSWORD=secure-production-password\nWORDPRESS_AUTH_METHOD=app-password\nNODE_ENV=production\nCACHE_ENABLED=true\nCACHE_TTL=3600\nRATE_LIMIT_ENABLED=true\nDEBUG=false\n```\n\n**Docker Production Setup**\n\n```dockerfile\n# Dockerfile.production\nFROM node:20-alpine\nWORKDIR /app\nCOPY package*.json ./\nRUN npm ci --only=production\nCOPY dist/ ./dist/\nEXPOSE 3000\nUSER node\nCMD [\"node\", \"dist/index.js\"]\n```\n\n### JWT Authentication Setup\n\n**WordPress Plugin Configuration**\n\n```php\n// wp-config.php\ndefine('JWT_AUTH_SECRET_KEY', 'your-secret-key-here');\ndefine('JWT_AUTH_CORS_ENABLE', true);\n```\n\n**MCP Configuration**\n\n```json\n{\n  \"sites\": [\n    {\n      \"id\": \"jwt-site\",\n      \"name\": \"JWT Authentication Site\",\n      \"config\": {\n        \"WORDPRESS_SITE_URL\": \"https://site-with-jwt.com\",\n        \"WORDPRESS_USERNAME\": \"api-user\",\n        \"WORDPRESS_PASSWORD\": \"user-password\",\n        \"WORDPRESS_AUTH_METHOD\": \"jwt\"\n      }\n    }\n  ]\n}\n```\n\n## 🌟 What Makes This Special\n\n### 🏆 Feature Comparison\n\n| Feature                    | This Server                          | Competition     |\n| -------------------------- | ------------------------------------ | --------------- |\n| **Tools Available**        | 59 tools                             | 20-30 tools     |\n| **Claude Desktop DXT**     | ✅ 2-click install                   | ❌ Manual setup |\n| **Multi-Site Support**     | ✅ Unlimited sites                   | ❌ Single site  |\n| **TypeScript**             | ✅ 100% coverage                     | ⚠️ Partial/None |\n| **Performance Monitoring** | ✅ Real-time analytics               | ❌ Basic only   |\n| **Test Coverage**          | ✅ 2200+ tests, comprehensive coverage | ⚠️ Limited      |\n| **Production Ready**       | ✅ Security audited                  | ⚠️ Unknown      |\n\n### 🚀 Core Capabilities\n\n#### WordPress Management\n\n- **59 WordPress Tools** across 10 categories\n- **Multi-Site Support** - Manage unlimited WordPress installations\n- **Flexible Authentication** - App Passwords, JWT, Basic Auth, API Key\n- **Real-Time Sync** - Instant updates across all connected tools\n\n#### Performance \u0026 Reliability\n\n- **⚡ Intelligent Caching** - 50-70% performance improvement\n- **📊 Real-Time Monitoring** - Performance metrics and optimization insights\n- **🔒 Production Ready** - Security-reviewed, 96.17% line coverage with Vitest testing framework\n- **🔄 Zero Downtime** - Graceful error handling and automatic recovery\n\n#### Developer Experience\n\n- **100% TypeScript** - Complete type safety and IntelliSense\n- **🐳 Docker Support** - Production-ready containerization\n- **📚 Auto-Generated Docs** - API documentation with live examples\n- **🔧 Extensible** - Custom tool development framework\n\n## 🌐 Multi-Site Configuration\n\nPerfect for agencies and developers managing multiple WordPress sites:\n\n```json\n{\n  \"sites\": [\n    {\n      \"id\": \"main-site\",\n      \"name\": \"Main WordPress Site\",\n      \"config\": {\n        \"WORDPRESS_SITE_URL\": \"https://site1.com\",\n        \"WORDPRESS_USERNAME\": \"admin\",\n        \"WORDPRESS_APP_PASSWORD\": \"xxxx xxxx xxxx xxxx xxxx xxxx\"\n      }\n    },\n    {\n      \"id\": \"client-blog\",\n      \"name\": \"Client Blog\",\n      \"config\": {\n        \"WORDPRESS_SITE_URL\": \"https://client-blog.com\",\n        \"WORDPRESS_USERNAME\": \"editor\",\n        \"WORDPRESS_APP_PASSWORD\": \"yyyy yyyy yyyy yyyy yyyy yyyy\"\n      }\n    }\n  ]\n}\n```\n\nUse with site parameter: `wp_list_posts --site=\"main-site\"`\n\n📖 **[Complete Multi-Site Setup Guide](docs/user-guides/NPM_SETUP.md#multi-site-configuration)**\n\n## 🔐 Authentication Setup\n\n### WordPress Application Passwords (Recommended)\n\n1. **WordPress Admin** → **Users** → **Profile**\n2. Scroll to **Application Passwords**\n3. Enter name: \"MCP WordPress Server\"\n4. Click **Add New Application Password**\n5. Copy the generated password\n\n### Alternative Methods\n\n- **JWT Authentication** - With JWT plugin\n- **Basic Authentication** - Username/password (dev only)\n- **API Key Authentication** - With API Key plugin\n\n📖 **[Complete Authentication Guide](docs/user-guides/NPX_SETUP.md#authentication)**\n\n## 📋 Available Tools (59 Tools)\n\n### Content Management\n\n- **📝 Posts** (6 tools) - Create, edit, delete, list posts and revisions\n- **📄 Pages** (6 tools) - Manage static pages and revisions\n- **🖼️ Media** (6 tools) - Upload, manage media library and files\n\n### User \u0026 Community\n\n- **👥 Users** (6 tools) - User management and profiles\n- **💬 Comments** (7 tools) - Comment moderation and management\n- **🏷️ Taxonomies** (10 tools) - Categories and tags management\n\n### Site Management (Monitoring \u0026 Admin)\n\n- **⚙️ Site Settings** (7 tools) - Site configuration and statistics\n- **🔐 Authentication** (6 tools) - Auth testing and management\n- **⚡ Cache Management** (4 tools) - Performance caching control\n- **📊 Performance Monitoring** (6 tools) - Real-time metrics and optimization\n\n📖 **[Complete Tool Documentation](docs/api/README.md)** | **[Live API Reference](docs/developer/API_REFERENCE.md)**\n\n## 🤖 Claude Desktop Integration\n\n### 🎯 Real-World Use Cases\n\n**Content Creation \u0026 Management:**\n\n```text\n💬 \"Analyze my top 10 blog posts and create a new post about emerging trends\"\n💬 \"Upload these 5 images and create a photo gallery page with SEO optimization\"\n💬 \"Review all pending comments and approve the legitimate ones\"\n```\n\n**Site Management \u0026 Analytics:**\n\n```text\n💬 \"Check my WordPress site performance and provide optimization recommendations\"\n💬 \"Create a new user account for my freelance writer with editor permissions\"\n💬 \"Backup my site settings and show me cache performance statistics\"\n```\n\n**Bulk Operations:**\n\n```text\n💬 \"Update all posts from 2023 to include my new author bio\"\n💬 \"Find all images over 1MB and suggest compression strategies\"\n💬 \"List all users who haven't logged in for 6 months\"\n```\n\n### ⚙️ Configuration Methods\n\n#### Option 1: DXT Extension (Recommended)\n\n**No configuration needed** - built-in secure credential management!\n\n#### Option 2: NPX in Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-wordpress\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-wordpress\"],\n      \"env\": {\n        \"WORDPRESS_SITE_URL\": \"https://your-site.com\",\n        \"WORDPRESS_USERNAME\": \"your-username\",\n        \"WORDPRESS_APP_PASSWORD\": \"your-app-password\"\n      }\n    }\n  }\n}\n```\n\n📖 **[Complete Integration Guide](docs/integrations/claude-desktop.md)**\n\n## 📚 Examples\n\n### Basic Content Management\n\n**Create and Publish a Blog Post**\n\n```text\nYou: \"Create a new blog post titled 'AI Revolution in 2024' with content about recent AI breakthroughs\"\nClaude: \"I'll create that blog post for you...\"\nResult: ✅ Post \"AI Revolution in 2024\" created successfully (ID: 123)\n```\n\n**Media Management**\n\n```text\nYou: \"Upload the image at /path/to/image.jpg and set it as featured image for post 123\"\nClaude: \"I'll upload that image and set it as the featured image...\"\nResult: ✅ Image uploaded (ID: 456) and set as featured image\n```\n\n### Advanced Workflows\n\n**SEO-Optimized Content Creation**\n\n```text\nYou: \"Create an SEO-optimized blog post about 'WordPress Security Best Practices' with:\n     - Focus keyword: 'WordPress security'\n     - Meta description\n     - Proper heading structure\n     - At least 1500 words\"\n\nClaude: \"I'll create a comprehensive SEO-optimized post on WordPress security...\"\n```\n\n**Bulk Operations**\n\n```text\nYou: \"Find all draft posts older than 30 days and provide a summary\"\nYou: \"Update all posts in category 'News' to include a disclaimer at the end\"\nYou: \"Delete all spam comments from the last week\"\n```\n\n### Site Management\n\n**Performance Monitoring**\n\n```text\nYou: \"Analyze my site's performance and suggest optimizations\"\nClaude: \"Let me check your site's performance metrics...\n         - Cache hit rate: 67%\n         - Average response time: 245ms\n         - Recommendations: Enable object caching, optimize images...\"\n```\n\n**User Management**\n\n```text\nYou: \"Create a new editor account for john@example.com with a secure password\"\nYou: \"List all users who haven't logged in for 90 days\"\nYou: \"Update Sarah's role from Author to Editor\"\n```\n\n### Multi-Site Management\n\n**Working with Multiple Sites**\n\n```text\nYou: \"List all posts from my client-blog site\"\nClaude: \"I'll list the posts from the client-blog site...\"\n\nYou: \"Compare traffic between main-site and client-blog\"\nClaude: \"Here's a comparison of both sites...\"\n```\n\n## 🎨 Real-World Workflows\n\n### Content Marketing Agency Workflow\n\n**Scenario**: Managing 20+ client blogs with consistent SEO optimization\n\n```text\n💬 \"Analyze the top 5 performing posts across all sites and create similar content for underperforming clients\"\n💬 \"Batch update all client sites with the new privacy policy footer\"\n💬 \"Generate a weekly performance report comparing all client sites\"\n💬 \"Create social media snippets from the latest blog posts on each site\"\n```\n\n### E-commerce Store Management\n\n**Scenario**: Managing product launches and inventory updates\n\n```text\n💬 \"Create a product launch post with gallery, specifications, and pricing for the new iPhone case\"\n💬 \"Update all 'out of stock' products with restock notifications\"\n💬 \"Generate product comparison pages for similar items\"\n💬 \"Create seasonal landing pages with current promotions\"\n```\n\n### News Website Operations\n\n**Scenario**: Breaking news and content moderation\n\n```text\n💬 \"Publish breaking news about the tech merger with social media integration\"\n💬 \"Moderate comments on controversial articles and flag inappropriate content\"\n💬 \"Create topic clusters around trending news stories\"\n💬 \"Schedule social media posts for peak engagement times\"\n```\n\n### Educational Institution Portal\n\n**Scenario**: Course management and student communications\n\n```text\n💬 \"Create course announcement pages with enrollment forms\"\n💬 \"Update faculty profiles with new publications and achievements\"\n💬 \"Generate student newsletter with upcoming events and deadlines\"\n💬 \"Moderate discussion forums and highlight valuable contributions\"\n```\n\n### Non-Profit Organization\n\n**Scenario**: Fundraising campaigns and volunteer coordination\n\n```text\n💬 \"Create donation campaign pages with progress tracking\"\n💬 \"Update volunteer opportunity listings with current needs\"\n💬 \"Generate impact reports showing donation effectiveness\"\n💬 \"Create event registration pages with automated confirmations\"\n```\n\n## 🚀 Advanced Automation Examples\n\n### Smart Content Workflows\n\n**Automated SEO Optimization**\n\n```text\nYou: \"Optimize all posts from the last month for better SEO performance\"\nClaude: \"I'll analyze and optimize your recent posts...\n- Analyzed 15 posts from the last 30 days\n- Updated meta descriptions for 12 posts\n- Added focus keywords to 8 posts\n- Optimized heading structure in 10 posts\n- Improved internal linking in 15 posts\n- Average SEO score improved from 67% to 89%\"\n```\n\n**Content Gap Analysis**\n\n```text\nYou: \"Identify content gaps in our blog compared to competitor topics\"\nClaude: \"After analyzing your content and common industry topics...\n- Missing topics: 'AI in Healthcare', 'Remote Work Security', 'Green Technology'\n- Underperforming categories: 'Tutorials' (only 3 posts vs 15+ needed)\n- Recommended: 8 new posts to fill major gaps\n- Priority topics based on search volume and competition\"\n```\n\n### Maintenance Automation\n\n**Site Health Monitoring**\n\n```text\nYou: \"Perform a comprehensive site health check and fix any issues\"\nClaude: \"Running complete site diagnostics...\n- ✅ SSL certificate valid (expires: March 15, 2025)\n- ⚠️ 3 broken internal links found and flagged\n- ✅ All images optimized (average load time: 1.2s)\n- ⚠️ 2 plugins need updates\n- ✅ Database optimized (reduced size by 15%)\n- ✅ Cache performance: 78% hit rate\"\n```\n\n**User Management Automation**\n\n```text\nYou: \"Clean up user accounts and update permissions for the new team structure\"\nClaude: \"Updating user management...\n- Deactivated 5 inactive accounts (no login \u003e6 months)\n- Updated 12 user roles to match new org chart\n- Created 3 new editor accounts for content team\n- Set up role-based content access restrictions\n- Configured automated welcome emails for new users\"\n```\n\n### Performance Optimization\n\n**Intelligent Cache Management**\n\n```text\nYou: \"Analyze site performance and implement optimal caching strategies\"\nClaude: \"Implementing performance optimizations...\n- Enabled object caching (40% speed improvement)\n- Configured CDN for static assets\n- Optimized database queries (reduced load time by 25%)\n- Set up page caching with smart invalidation\n- Compressed and optimized 47 images\n- Site speed improved from 3.2s to 1.8s average load time\"\n```\n\n## 🎯 Industry-Specific Solutions\n\n### Healthcare Practices\n\n```text\n💬 \"Create HIPAA-compliant patient information pages with secure forms\"\n💬 \"Update doctor profiles with latest certifications and specializations\"\n💬 \"Generate appointment booking pages with calendar integration\"\n💬 \"Create health education content with medical disclaimers\"\n```\n\n### Legal Firms\n\n```text\n💬 \"Create practice area pages with case study examples\"\n💬 \"Update attorney profiles with recent wins and bar admissions\"\n💬 \"Generate client intake forms with confidentiality notices\"\n💬 \"Create legal blog posts with proper citations and disclaimers\"\n```\n\n### Real Estate Agencies\n\n```text\n💬 \"Create property listing pages with virtual tour embeds\"\n💬 \"Update agent profiles with recent sales and market statistics\"\n💬 \"Generate neighborhood guide pages with local amenities\"\n💬 \"Create mortgage calculator pages with current rates\"\n```\n\n### Restaurants \u0026 Food Service\n\n```text\n💬 \"Create menu pages with dietary restriction filters\"\n💬 \"Update chef profiles with signature dishes and cooking philosophy\"\n💬 \"Generate event booking pages for private dining\"\n💬 \"Create food blog posts with recipe cards and nutritional information\"\n```\n\n📖 **[More Examples](docs/examples/)** | **[Use Case Library](docs/use-cases/)**\n\n## 🛠️ Troubleshooting Guide\n\n### Quick Diagnostics\n\n**Connection Issues**\n\n```bash\n# Test WordPress connection\nnpm run status\n\n# Debug mode with detailed logs\nDEBUG=true npm run dev\n\n# Test specific site in multi-site setup\nnpm run status -- --site=\"your-site-id\"\n```\n\n**Authentication Problems**\n\n```bash\n# Verify WordPress application password\ncurl -u username:app_password https://your-site.com/wp-json/wp/v2/users/me\n\n# Test authentication with different methods\nnpm run test:auth\n\n# Regenerate application password\nnpm run setup\n```\n\n**Performance Issues**\n\n```bash\n# Check cache performance\nnpm run test:cache\n\n# Monitor real-time performance\nnpm run test:performance\n\n# Clear all caches\nrm -rf cache/ \u0026\u0026 npm run dev\n```\n\n### Common Error Solutions\n\n| Error                         | Cause                    | Solution                           |\n| ----------------------------- | ------------------------ | ---------------------------------- |\n| `401 Unauthorized`            | Invalid credentials      | Regenerate application password    |\n| `403 Forbidden`               | Insufficient permissions | Check user role (Editor+ required) |\n| `404 Not Found`               | Wrong site URL           | Verify WORDPRESS_SITE_URL          |\n| `SSL Certificate Error`       | HTTPS issues             | Add SSL exception or use HTTP      |\n| `Connection Timeout`          | Network/firewall         | Check WordPress REST API access    |\n| `Tools not showing in Claude` | Config file format       | Validate JSON syntax               |\n| `Plugin conflicts`            | WordPress plugins        | Disable conflicting plugins        |\n| `Rate limiting`               | Too many requests        | Implement request throttling       |\n\n### WordPress-Specific Issues\n\n**REST API Not Available**\n\n```bash\n# Test REST API directly\ncurl https://your-site.com/wp-json/wp/v2/\n\n# Check if REST API is disabled\ngrep -r \"rest_api\" wp-config.php\n\n# Verify permalink structure\nwp-admin → Settings → Permalinks → Post name\n```\n\n**Application Password Issues**\n\n```text\n1. WordPress Admin → Users → Profile\n2. Scroll to \"Application Passwords\"\n3. Ensure feature is enabled (WordPress 5.6+)\n4. Generate new password if needed\n5. Copy password exactly (includes spaces)\n```\n\n**Multi-Site Configuration Problems**\n\n```json\n// Check mcp-wordpress.config.json format\n{\n  \"sites\": [\n    {\n      \"id\": \"unique-site-id\",\n      \"name\": \"Human Readable Name\",\n      \"config\": {\n        \"WORDPRESS_SITE_URL\": \"https://site.com\",\n        \"WORDPRESS_USERNAME\": \"username\",\n        \"WORDPRESS_APP_PASSWORD\": \"xxxx xxxx xxxx xxxx xxxx xxxx\"\n      }\n    }\n  ]\n}\n```\n\n### Environment-Specific Solutions\n\n**Claude Desktop Integration**\n\n```json\n// Verify claude_desktop_config.json format\n{\n  \"mcpServers\": {\n    \"mcp-wordpress\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-wordpress\"],\n      \"env\": {\n        \"WORDPRESS_SITE_URL\": \"https://your-site.com\",\n        \"WORDPRESS_USERNAME\": \"your-username\",\n        \"WORDPRESS_APP_PASSWORD\": \"your-app-password\"\n      }\n    }\n  }\n}\n```\n\n**Docker Deployment Issues**\n\n```bash\n# Check container logs\ndocker logs mcp-wordpress\n\n# Verify environment variables\ndocker exec mcp-wordpress env | grep WORDPRESS\n\n# Test network connectivity\ndocker exec mcp-wordpress curl https://your-site.com/wp-json/wp/v2/\n```\n\n**NPX Runtime Problems**\n\n```bash\n# Clear NPX cache\nnpx clear-npx-cache\n\n# Use specific version\nnpx mcp-wordpress@latest\n\n# Install globally instead\nnpm install -g mcp-wordpress\n```\n\n### Getting Help\n\n**Self-Diagnostics**\n\n```bash\n# Comprehensive health check\nnpm run health\n\n# Security validation\nnpm run security:check\n\n# Performance analysis\nnpm run test:performance\n```\n\n**Debug Information Collection**\n\n```bash\n# Generate debug report\nDEBUG=true npm run status \u003e debug-report.txt 2\u003e\u00261\n\n# Include system information\nnode --version \u003e\u003e debug-report.txt\nnpm --version \u003e\u003e debug-report.txt\nos-info \u003e\u003e debug-report.txt\n```\n\n**Community Support**\n\n- 🐛 [Report Issues](https://github.com/docdyhr/mcp-wordpress/issues)\n- 💬 [Discussions](https://github.com/docdyhr/mcp-wordpress/discussions)\n- 📧 [Security Issues](mailto:security@docdyhr.com)\n- 📚 [Documentation](docs/TROUBLESHOOTING.md)\n\n## 🧪 Testing \u0026 Status\n\n### Current Test Status ✅\n\n- **Main Test Suite**: 512/512 passed (100%) with Vitest\n- **Security Tests**: 40/40 passed (100%)\n- **Performance Tests**: 8/8 passed (100%)\n- **CI/CD Pipeline**: Fully functional with Vitest integration\n\n### Test Your Installation\n\n```bash\n# Check connection status\nnpm run status\n\n# Run full test suite (Vitest)\nnpm test\n\n# Run tests with coverage\nnpm run test:coverage\n\n# Quick validation\nnpm run test:fast\n```\n\n## 🔒 Security Status\n\n### Comprehensive Security Testing\n\nOur security posture is continuously monitored through automated testing and vulnerability scanning:\n\n| **Security Area**          | **Status** | **Tests**     | **Coverage**                                        |\n| -------------------------- | ---------- | ------------- | --------------------------------------------------- |\n| **XSS Protection**         | ✅ Secure  | 6/6 passing   | Script injection, URL validation, HTML sanitization |\n| **SQL Injection**          | ✅ Secure  | 3/3 passing   | Query parameterization, input validation            |\n| **Path Traversal**         | ✅ Secure  | 3/3 passing   | File path validation, directory restrictions        |\n| **Input Validation**       | ✅ Secure  | 9/9 passing   | Length limits, format validation, sanitization      |\n| **Authentication**         | ✅ Secure  | 7/7 passing   | Bypass prevention, token validation                 |\n| **Rate Limiting**          | ✅ Secure  | 3/3 passing   | DoS protection, request throttling                  |\n| **Information Disclosure** | ✅ Secure  | 2/2 passing   | Error sanitization, sensitive data protection       |\n| **Penetration Testing**    | ✅ Secure  | 12/12 passing | Comprehensive attack simulation                     |\n\n### Security Features\n\n- **🛡️ Input Sanitization**: All user inputs are validated and sanitized\n- **🔐 Authentication Security**: Multi-method auth with bypass prevention\n- **⚡ Rate Limiting**: Built-in protection against abuse and DoS attacks\n- **🔍 Vulnerability Scanning**: Daily automated security scans\n- **📊 Real-time Monitoring**: Continuous security status updates\n- **🚨 Automated Alerts**: Immediate notification of security issues\n\n### Security Testing Commands\n\n```bash\n# Run comprehensive security tests\nnpm run test:security\n\n# Run penetration testing suite\nnpm run test:security:validation\n\n# Security vulnerability audit\nnpm audit\n\n# Full security validation\nnpm run security:full\n```\n\n### Security Compliance\n\n- **OWASP Top 10**: Complete protection against common vulnerabilities\n- **CVE Monitoring**: Automated scanning for known vulnerabilities\n- **Security Headers**: Proper HTTP security headers implementation\n- **Data Protection**: Sensitive credential redaction and secure storage\n- **Access Control**: Role-based permissions and authentication validation\n\n📖 **[Complete Security Documentation](docs/SECURITY.md)** | **[Security Test Results](tests/security/)**\n\n## 🐛 Troubleshooting\n\n### Common Issues\n\n1. **\"Cannot connect to WordPress\"**\n\n   - Verify `WORDPRESS_SITE_URL`\n   - Test REST API: `curl https://your-site.com/wp-json/wp/v2/`\n\n2. **\"Authentication failed\"**\n\n   - Check username and application password\n   - Ensure Application Passwords are enabled\n   - Run `npm run setup` to reconfigure\n\n3. **\"Tools not appearing in Claude\"**\n   - Restart Claude Desktop after configuration\n   - Check Claude Desktop config file format\n\n### Get Help\n\n```bash\n# Debug mode\nDEBUG=true npm run dev\n\n# Connection test\nnpm run status\n\n# Re-run setup wizard\nnpm run setup\n```\n\n## 📚 Documentation\n\n### Getting Started\n\n- **[Quick Start Guide](#-quick-start)** - Get running in 5 minutes\n- **[Installation Guide](docs/INSTALLATION.md)** - Detailed setup instructions\n- **[Configuration Guide](docs/CONFIGURATION.md)** - All configuration options\n- **[Authentication Setup](docs/SECURITY.md#authentication)** - WordPress auth methods\n\n### User Guides\n\n- **[Basic Usage](docs/examples/basic-usage.md)** - Common tasks and workflows\n- **[Advanced Workflows](docs/examples/advanced-workflows.md)** - Complex automation\n- **[Multi-Site Management](docs/user-guides/multi-site.md)** - Managing multiple sites\n- **[Troubleshooting](docs/TROUBLESHOOTING.md)** - Common issues and solutions\n\n### Integration Guides\n\n- **[Claude Desktop](docs/integrations/claude-desktop.md)** - Complete Claude integration\n- **[VS Code](docs/integrations/vs-code.md)** - VS Code extension setup\n- **[Cline](docs/integrations/cline.md)** - Cline AI assistant integration\n- **[Custom Clients](docs/developer/custom-clients.md)** - Build your own MCP client\n\n### Developer Documentation\n\n- **[API Reference](docs/API_REFERENCE.md)** - Complete tool documentation\n- **[Architecture](docs/ARCHITECTURE.md)** - System design and decisions\n- **[Contributing](CONTRIBUTING.md)** - Development guidelines\n- **[Plugin Development](docs/developer/plugins.md)** - Extend functionality\n\n### Deployment \u0026 Operations\n\n- **[Docker Deployment](docs/deployment/docker.md)** - Container deployment\n- **[Publishing Troubleshooting](docs/PUBLISHING-TROUBLESHOOTING.md)** - Fix publishing issues\n- **[Security Best Practices](docs/SECURITY.md)** - Production security\n- **[Performance Tuning](docs/deployment/performance.md)** - Optimization guide\n- **[Monitoring](docs/deployment/monitoring.md)** - Logging and metrics\n\n## 🔧 Requirements\n\n- **WordPress 5.0+** with REST API enabled\n- **HTTPS recommended** for production\n- **User with appropriate permissions**\n- **Application Passwords enabled** (WordPress 5.6+)\n\n### WordPress User Roles\n\n| Role              | Access                        |\n| ----------------- | ----------------------------- |\n| **Administrator** | Full access to all functions  |\n| **Editor**        | Posts, pages, comments, media |\n| **Author**        | Own posts and media           |\n| **Contributor**   | Own posts (drafts only)       |\n| **Subscriber**    | Read only                     |\n\n## 📦 Installation Options\n\n### NPM Package\n\n```bash\n# Global installation\nnpm install -g mcp-wordpress\n\n# Direct usage (recommended)\nnpx -y mcp-wordpress\n```\n\n### Docker Images\n\n```bash\n# Latest version\ndocker pull docdyhr/mcp-wordpress:latest\n\n# Specific version\ndocker pull docdyhr/mcp-wordpress:1.3.1\n```\n\n### Distribution Channels\n\n- **NPM:** [`mcp-wordpress`](https://www.npmjs.com/package/mcp-wordpress)\n- **Docker Hub:** [`docdyhr/mcp-wordpress`](https://hub.docker.com/r/docdyhr/mcp-wordpress)\n- **GitHub:** [Latest releases](https://github.com/docdyhr/mcp-wordpress/releases)\n\n## 🚀 Next Steps\n\n**Ready to transform your WordPress management?**\n\n1. **🏆\n   [Download DXT Extension](https://github.com/docdyhr/mcp-wordpress/releases/latest/download/mcp-wordpress.dxt)** -\n   Easiest setup (2 minutes)\n2. **⚡ [Try NPX Method](docs/user-guides/NPX_SETUP.md)** - Power user setup (5 minutes)\n3. **📚 [Explore All Tools](docs/api/README.md)** - See what's possible\n4. **💬 [Join Discussions](https://github.com/docdyhr/mcp-wordpress/discussions)** - Get help and share ideas\n\n---\n\n## 🔗 Similar Projects\n\nLooking for alternatives or complementary tools? Check out these WordPress MCP implementations:\n\n- **[Automattic WordPress MCP](https://github.com/Automattic/wordpress-mcp)** - Official WordPress MCP server by\n  Automattic\n\n---\n\n## 📋 Changelog\n\n### v2.12.0 (December 2024) 🎉\n\n- **🏗️ Modular Architecture** - Split large files into domain-specific operation modules\n- **🔄 Circuit Breaker Pattern** - Fault tolerance for external API calls with automatic recovery\n- **📊 2200+ Tests** - Comprehensive test suite with operations and performance helper coverage\n- **📚 Deprecation Documentation** - Clear migration timeline for deprecated modules\n- **🔒 Security Improvements** - Updated dependencies and consolidated CI/CD workflows\n\n### v2.5.4+ (August 2024)\n\n- **🆕 Multi-Site DXT Extension** - New UI toggle for managing multiple WordPress sites in Claude Desktop\n- **🔧 Enhanced Configuration** - Auto-detection of multi-site configuration files\n- **⚡ Performance Improvements** - Optimized caching and request handling\n- **🛡️ Security Updates** - Enhanced input validation and dependency updates\n- **🐛 Bug Fixes** - Resolved hook path issues and improved error handling\n- **📚 Documentation** - Updated setup guides and troubleshooting information\n\n### v2.5.0 (July 2024)\n\n- **🚀 Production Ready** - Comprehensive testing suite with 96%+ coverage\n- **🔒 Security Framework** - Full security validation and penetration testing\n- **📊 Performance Analytics** - Real-time monitoring and optimization tools\n- **🎯 Tool Enhancements** - 59 WordPress management tools across 10 categories\n\n### v2.0.0 (June 2024)\n\n- **🏗️ Architecture Overhaul** - Migrated to modern TypeScript architecture\n- **🌐 Multi-Site Support** - Complete multi-site WordPress management\n- **💾 Intelligent Caching** - 50-70% performance improvement\n- **🔐 Authentication Methods** - Support for 4 authentication types\n\n---\n\n## 🙏 Acknowledgments\n\nSpecial thanks to **[Stephan Ferraro](https://github.com/ferraro)** for the upstream project that inspired this\nimplementation.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**⭐ Found this helpful? [Give us a star on GitHub!](https://github.com/docdyhr/mcp-wordpress) ⭐**\n\n\u003c/div\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocdyhr%2Fmcp-wordpress","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdocdyhr%2Fmcp-wordpress","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocdyhr%2Fmcp-wordpress/lists"}