mcp-wordpress 1.2.0 → 1.2.3

package/README.md

@@ -7,9 +7,9 @@
 A comprehensive Model Context Protocol (MCP) server for WordPress management through the WordPress REST API v2. Completely written in TypeScript with modular architecture and 95%+ test coverage.
 
 [![NPM Version](https://img.shields.io/npm/v/mcp-wordpress)](https://www.npmjs.com/package/mcp-wordpress)
-[![Test Coverage](https://img.shields.io/badge/test%20coverage-95%25%2B-brightgreen)](https://github.com/thomasdyhr/mcp-wordpress)
-[![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue)](https://github.com/thomasdyhr/mcp-wordpress)
-[![Architecture](https://img.shields.io/badge/architecture-modular-orange)](https://github.com/thomasdyhr/mcp-wordpress/blob/main/REFACTORING.md)
+[![Test Coverage](https://img.shields.io/badge/test%20coverage-95%25%2B-brightgreen)](https://github.com/docdyhr/mcp-wordpress)
+[![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue)](https://github.com/docdyhr/mcp-wordpress)
+[![Architecture](https://img.shields.io/badge/architecture-modular-orange)](https://github.com/docdyhr/mcp-wordpress/blob/main/REFACTORING.md)
 
 ## 🚀 Features
 
@@ -46,7 +46,7 @@ mcp-wordpress
 ### Option 2: Local Development
 
 ```bash
-git clone https://github.com/thomasdyhr/mcp-wordpress.git
+git clone https://github.com/docdyhr/mcp-wordpress.git
 cd mcp-wordpress
 npm install
 npm run setup
@@ -63,7 +63,29 @@ npx mcp-wordpress setup
 npm run setup
 ```
 
-## 🏆 Latest Achievement: v1.2.0 - Performance & Documentation Revolution
+## 🏆 Latest Achievement: v1.2.1 - Test Infrastructure & Multi-Site Enhancement
+
+Building on v1.2.0's performance monitoring and documentation features, v1.2.1 delivers **100% test reliability**, **enhanced multi-site support**, and **production-ready repository organization**:
+
+### ✅ Test Infrastructure Overhaul (v1.2.1)
+
+- **🔧 100% Test Success Rate**: Fixed all failing integration and tool tests
+- **🌐 Multi-Site Testing**: Comprehensive test suite for multi-site WordPress configurations  
+- **🛡️ Enhanced Security**: Improved .gitignore and credential protection
+- **📋 Test Organization**: Streamlined test scripts and better error reporting
+- **⚡ Quick Validation**: New `npm run test:multisite` command for rapid configuration testing
+
+### 🌐 Multi-Site Configuration Enhancements (v1.2.1)
+
+- **📝 Complete Documentation**: Comprehensive Claude Desktop setup guide for multi-site usage
+- **🔧 Fixed Configuration**: Resolved JWT authentication validation issues
+- **✅ Site Validation**: Enhanced uniqueness checks for site URLs and IDs
+- **🚀 Quick Testing**: Instant validation of all configured WordPress sites
+- **📊 Status Reporting**: Clear success/failure reporting for each site configuration
+
+---
+
+## 🏆 Previous Achievement: v1.2.0 - Performance & Documentation Revolution
 
 We've implemented a **comprehensive performance monitoring system**, **intelligent caching**, **auto-generated documentation**, and **Docker containerization** - all while maintaining complete backward compatibility:
 
@@ -106,13 +128,16 @@ We've implemented a **comprehensive performance monitoring system**, **intellige
 - [API Documentation](./docs/api/README.md)
 - [Docker Deployment Guide](./docs/DOCKER.md)
 
-## 🔐 Authentication & Testing Status
+## 🔐 Authentication & Testing Status (v1.2.1)
 
 ✅ **Application Passwords** - Tested and working perfectly
 ✅ **JWT Authentication** - Supported with plugin  
 ✅ **Basic Authentication** - Development ready
 ✅ **API Key Authentication** - Plugin-based support
-✅ **All Tests Passing** - 100% success rate (41/41 tests)
+✅ **Integration Tests** - 100% success rate (9/9 tests passing)
+✅ **Multi-Site Tests** - 100% success rate (3/3 sites verified)
+✅ **Security Tests** - 100% success rate (40/40 tests passing)
+✅ **Performance Tests** - 100% success rate (8/8 tests passing)
 ✅ **Tool Tests** - 100% success rate (14/14 tools working)
 
 The setup wizard guides you through:
@@ -148,8 +173,8 @@ I want to use the NPX version (mcp-wordpress) so I don't need to install anythin
 
 For local development and customization:
 
-```
-Build and configure the MCP WordPress server project from https://github.com/thomasdyhr/mcp-wordpress locally on my computer. 
+```text
+Build and configure the MCP WordPress server project from https://github.com/docdyhr/mcp-wordpress locally on my computer. 
 
 Please:
 1. Clone the repository to an appropriate directory
@@ -291,6 +316,139 @@ Here's a complete `claude_desktop_config.json` file with MCP WordPress:
 }
 ```
 
+## 🌐 Multi-Site Configuration
+
+MCP WordPress Server supports managing multiple WordPress sites from a single configuration. This is perfect for agencies, developers managing multiple client sites, or anyone with multiple WordPress installations.
+
+### Setting Up Multi-Site Configuration
+
+1. **Create a `mcp-wordpress.config.json` file** in your project root:
+
+```json
+{
+  "sites": [
+    {
+      "id": "site1",
+      "name": "My Main Site",
+      "config": {
+        "WORDPRESS_SITE_URL": "https://site1.com",
+        "WORDPRESS_USERNAME": "admin",
+        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
+      }
+    },
+    {
+      "id": "site2", 
+      "name": "My Blog",
+      "config": {
+        "WORDPRESS_SITE_URL": "https://blog.site2.com",
+        "WORDPRESS_USERNAME": "editor",
+        "WORDPRESS_APP_PASSWORD": "yyyy yyyy yyyy yyyy yyyy yyyy",
+        "WORDPRESS_AUTH_METHOD": "app-password"
+      }
+    },
+    {
+      "id": "dev",
+      "name": "Development Site",
+      "config": {
+        "WORDPRESS_SITE_URL": "http://localhost:8080",
+        "WORDPRESS_USERNAME": "dev_user",
+        "WORDPRESS_APP_PASSWORD": "zzzz zzzz zzzz zzzz zzzz zzzz"
+      }
+    }
+  ]
+}
+```
+
+1. **Configure Claude Desktop for Multi-Site**:
+
+```json
+{
+  "mcpServers": {
+    "mcp-wordpress": {
+      "command": "npx",
+      "args": ["mcp-wordpress"]
+    }
+  }
+}
+```
+
+Note: When using multi-site configuration, you don't need to specify environment variables in Claude Desktop. The server will read from your `mcp-wordpress.config.json` file.
+
+### Using Multi-Site Tools
+
+When you have multiple sites configured, all tools require a `site` parameter:
+
+```text
+# List posts from site1
+wp_list_posts --site="site1"
+
+# Create a post on the blog site
+wp_create_post --site="site2" --title="New Blog Post" --content="Content here"
+
+# Get user info from development site
+wp_get_current_user --site="dev"
+```
+
+### Important Multi-Site Notes
+
+- **Site IDs must be unique** - Each site needs a unique identifier
+- **Security**: The `mcp-wordpress.config.json` file contains sensitive credentials and should NEVER be committed to version control
+- **Default Site**: If only one site is configured, it will be used by default without needing the `--site` parameter
+- **Authentication**: Each site can use different authentication methods (app-password, jwt, basic, api-key)
+
+### Example: Managing Multiple Client Sites
+
+```json
+{
+  "sites": [
+    {
+      "id": "client-acme",
+      "name": "ACME Corporation",
+      "config": {
+        "WORDPRESS_SITE_URL": "https://acme-corp.com",
+        "WORDPRESS_USERNAME": "mcp_admin",
+        "WORDPRESS_APP_PASSWORD": "aaaa bbbb cccc dddd eeee ffff"
+      }
+    },
+    {
+      "id": "client-tech",
+      "name": "TechStartup Blog",
+      "config": {
+        "WORDPRESS_SITE_URL": "https://blog.techstartup.io",
+        "WORDPRESS_USERNAME": "content_manager",
+        "WORDPRESS_APP_PASSWORD": "gggg hhhh iiii jjjj kkkk llll"
+      }
+    },
+    {
+      "id": "client-shop",
+      "name": "Online Shop",
+      "config": {
+        "WORDPRESS_SITE_URL": "https://shop.example.com",
+        "WORDPRESS_USERNAME": "shop_admin",
+        "WORDPRESS_APP_PASSWORD": "mmmm nnnn oooo pppp qqqq rrrr",
+        "WORDPRESS_AUTH_METHOD": "jwt",
+        "WORDPRESS_JWT_SECRET": "your-jwt-secret-here"
+      }
+    }
+  ]
+}
+```
+
+Then in Claude Desktop, you can manage all sites:
+
+```text
+# Check posts across all client sites
+wp_list_posts --site="client-acme" --per_page=5
+wp_list_posts --site="client-tech" --per_page=5
+wp_list_posts --site="client-shop" --per_page=5
+
+# Update content on specific sites
+wp_update_post --site="client-acme" --id=123 --title="Updated Title"
+
+# Manage media across sites
+wp_list_media --site="client-shop" --media_type="image"
+```
+
 ## 🛠 Build System
 
 ### TypeScript Build
@@ -529,7 +687,7 @@ npm run lint:fix
 
 ## 🏗 Project Structure
 
-```
+```diagram
 mcp-wordpress/
 ├── src/                     # TypeScript source code
 │   ├── index.ts            # Main MCP server
@@ -632,10 +790,10 @@ docker run -d \
   -e WORDPRESS_SITE_URL=https://your-site.com \
   -e WORDPRESS_USERNAME=your-username \
   -e WORDPRESS_APP_PASSWORD=your-app-password \
-  aiondadotcom/mcp-wordpress:latest
+  docdyhr/mcp-wordpress:latest
 
 # Using Docker Compose
-curl -O https://raw.githubusercontent.com/thomasdyhr/mcp-wordpress/main/docker-compose.yml
+curl -O https://raw.githubusercontent.com/docdyhr/mcp-wordpress/main/docker-compose.yml
 docker-compose up -d
 ```
 
@@ -645,7 +803,7 @@ docker-compose up -d
 version: '3.8'
 services:
   mcp-wordpress:
-    image: aiondadotcom/mcp-wordpress:latest
+    image: docdyhr/mcp-wordpress:latest
     restart: unless-stopped
     environment:
       - WORDPRESS_SITE_URL=https://your-site.com
@@ -665,7 +823,7 @@ services:
 
 Test the MCP server against a real WordPress instance using our automated testing setup:
 
-```bash
+```bash copy
 # Automated live contract testing (recommended)
 npm run test:contracts:live
 ```
@@ -730,3 +888,99 @@ npm run test:contracts
   - One-command deployment to any Docker environment
 
 **📚 Read the full release notes for all details!**
+
+## 🚀 Release & Publishing
+
+This project uses automated semantic versioning and publishing to NPM and Docker Hub.
+
+### 📦 Installation Options
+
+**NPM Package:**
+
+```bash
+# Latest stable version
+npm install -g mcp-wordpress
+
+# Specific version
+npm install -g mcp-wordpress@1.2.2
+
+# Use with npx (no installation)
+npx mcp-wordpress
+```
+
+**Docker Images:**
+
+```bash
+# Latest stable version
+docker pull docdyhr/mcp-wordpress:latest
+
+# Specific version
+docker pull docdyhr/mcp-wordpress:1.2.2
+
+# Run directly
+docker run -d docdyhr/mcp-wordpress:latest
+```
+
+### 🏷️ Release Process
+
+**Automated Releases:**
+
+- Releases are automatically created when conventional commits are pushed to the `main` branch
+- Semantic versioning determines the version bump automatically
+- NPM and Docker Hub publishing happens automatically on release
+
+**Conventional Commit Format:**
+
+```bash
+# Patch release (1.2.2 → 1.2.3)
+fix: resolve authentication timeout issue
+
+# Minor release (1.2.2 → 1.3.0)  
+feat: add new performance monitoring tools
+
+# Major release (1.2.2 → 2.0.0)
+feat!: redesign MCP tool interface
+BREAKING CHANGE: tool parameter structure has changed
+```
+
+**Manual Release (if needed):**
+
+```bash
+# Test release locally
+npm run release:dry
+
+# Create release manually (requires proper permissions)
+npm run release
+```
+
+### 📋 Release Checklist
+
+For contributors planning releases:
+
+1. **Pre-Release Validation:**
+   - ✅ All tests passing (`npm test`)
+   - ✅ Documentation updated
+   - ✅ Performance benchmarks within acceptable range
+   - ✅ Security audit clean (`npm audit`)
+
+2. **Commit with Conventional Format:**
+
+   ```bash
+   git add .
+   git commit -m "feat: add new functionality"
+   git push origin main
+   ```
+
+3. **Automated Process Handles:**
+   - 📝 Generate release notes
+   - 🏷️ Create GitHub release  
+   - 📦 Publish to NPM with provenance
+   - 🐳 Build and push Docker images (multi-arch)
+   - 📚 Update CHANGELOG.md
+   - 🔗 Update Docker Hub description
+
+### 🌍 Distribution Channels
+
+- **NPM:** [`mcp-wordpress`](https://www.npmjs.com/package/mcp-wordpress)
+- **Docker Hub:** [`docdyhr/mcp-wordpress`](https://hub.docker.com/r/docdyhr/mcp-wordpress)
+- **GitHub Releases:** [Latest releases](https://github.com/docdyhr/mcp-wordpress/releases)

package/dist/security/SecurityConfig.d.ts

@@ -38,11 +38,11 @@ export declare const SecurityConfig: {
         auth: number;
     };
     headers: {
-        "X-Content-Type-Options": string;
-        "X-Frame-Options": string;
-        "X-XSS-Protection": string;
-        "Strict-Transport-Security": string;
-        "Content-Security-Policy": string;
+        'X-Content-Type-Options': string;
+        'X-Frame-Options': string;
+        'X-XSS-Protection': string;
+        'Strict-Transport-Security': string;
+        'Content-Security-Policy': string;
     };
     errorMessages: {
         authentication: string;

package/dist/security/SecurityConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SecurityConfig.d.ts","sourceRoot":"","sources":["../../src/security/SecurityConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwK1B,CAAC;AAEF;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG;IAsBzC;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAUxC;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM;IAgBvD;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKxD;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG;CAStC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,GAAG,EACV,eAAe,GAAE,MAAiD,GACjE,KAAK,CAeP;AAKD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;CACvB,CAQA"}
+{"version":3,"file":"SecurityConfig.d.ts","sourceRoot":"","sources":["../../src/security/SecurityConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwK1B,CAAC;AAEF;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG;IAsBzC;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAUxC;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM;IAgBvD;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKxD;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG;CAStC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,GAAG,EACV,eAAe,GAAE,MAAiD,GACjE,KAAK,CAeP;AAKD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;CACrB,CAQF"}