mcp-wordpress 1.3.0 → 1.3.1

package/docs/api/categories/auth.md

@@ -19,6 +19,7 @@ Authentication testing and management tools
 ## Examples
 
 ### Basic auth Workflow
+
 ```bash
 # List all auth
 wp_list_auth
@@ -31,6 +32,7 @@ wp_create_aut --title="Example"
 ```
 
 ### Multi-Site auth Management
+
 ```bash
 # Work with specific site
 wp_list_auth --site=production

package/docs/api/categories/cache.md

@@ -20,6 +20,7 @@ Performance caching and optimization tools
 ## Examples
 
 ### Basic cache Workflow
+
 ```bash
 # List all cache
 wp_list_cache
@@ -32,6 +33,7 @@ wp_create_cach --title="Example"
 ```
 
 ### Multi-Site cache Management
+
 ```bash
 # Work with specific site
 wp_list_cache --site=production

package/docs/api/categories/comment.md

@@ -23,6 +23,7 @@ comment management tools
 ## Examples
 
 ### Basic comment Workflow
+
 ```bash
 # List all comment
 wp_list_comment
@@ -35,6 +36,7 @@ wp_create_commen --title="Example"
 ```
 
 ### Multi-Site comment Management
+
 ```bash
 # Work with specific site
 wp_list_comment --site=production

package/docs/api/categories/media.md

@@ -22,6 +22,7 @@ File upload, management, and media library tools
 ## Examples
 
 ### Basic media Workflow
+
 ```bash
 # List all media
 wp_list_media
@@ -34,6 +35,7 @@ wp_create_medi --title="Example"
 ```
 
 ### Multi-Site media Management
+
 ```bash
 # Work with specific site
 wp_list_media --site=production

package/docs/api/categories/page.md

@@ -22,6 +22,7 @@ page management tools
 ## Examples
 
 ### Basic page Workflow
+
 ```bash
 # List all page
 wp_list_page
@@ -34,6 +35,7 @@ wp_create_pag --title="Example"
 ```
 
 ### Multi-Site page Management
+
 ```bash
 # Work with specific site
 wp_list_page --site=production

package/docs/api/categories/performance.md

@@ -23,6 +23,7 @@ Performance monitoring and analytics tools
 ## Examples
 
 ### Basic performance Workflow
+
 ```bash
 # List all performance
 wp_list_performance
@@ -35,6 +36,7 @@ wp_create_performanc --title="Example"
 ```
 
 ### Multi-Site performance Management
+
 ```bash
 # Work with specific site
 wp_list_performance --site=production

package/docs/api/categories/post.md

@@ -22,6 +22,7 @@ post management tools
 ## Examples
 
 ### Basic post Workflow
+
 ```bash
 # List all post
 wp_list_post
@@ -34,6 +35,7 @@ wp_create_pos --title="Example"
 ```
 
 ### Multi-Site post Management
+
 ```bash
 # Work with specific site
 wp_list_post --site=production

package/docs/api/categories/taxonomy.md

@@ -26,6 +26,7 @@ taxonomy management tools
 ## Examples
 
 ### Basic taxonomy Workflow
+
 ```bash
 # List all taxonomy
 wp_list_taxonomy
@@ -38,6 +39,7 @@ wp_create_taxonom --title="Example"
 ```
 
 ### Multi-Site taxonomy Management
+
 ```bash
 # Work with specific site
 wp_list_taxonomy --site=production

package/docs/api/categories/user.md

@@ -22,6 +22,7 @@ user management tools
 ## Examples
 
 ### Basic user Workflow
+
 ```bash
 # List all user
 wp_list_user
@@ -34,6 +35,7 @@ wp_create_use --title="Example"
 ```
 
 ### Multi-Site user Management
+
 ```bash
 # Work with specific site
 wp_list_user --site=production

package/docs/api/tools/wp_approve_comment.md

@@ -17,11 +17,13 @@ Approves a pending comment.
 Simple example of using wp_approve_comment
 
 **Command:**
+
 ```bash
 wp_approve_comment --id="123"
 ```
 
 **Response:**
+
 ```json
 {
   "success": true,
@@ -31,6 +33,7 @@ wp_approve_comment --id="123"
 ```
 
 **Error Example (Authentication failure):**
+
 ```json
 {
   "error": "Authentication failed",
@@ -38,11 +41,6 @@ wp_approve_comment --id="123"
 }
 ```
 
-
-
-
-
-
 ## Response Format
 
 **Return Type:** `object`

package/docs/user-guides/DOCKER_NPM_DTX_SETUP.md

@@ -0,0 +1,217 @@
+# Docker, NPM, and DTX Setup Guide
+
+This guide provides step-by-step instructions for setting up the MCP WordPress server using Docker, NPM, and DTX, including Claude Desktop configuration.
+
+---
+
+## 🚀 Docker Setup
+
+### 1. Build the Docker Image
+
+Use the provided `Dockerfile` to build the MCP WordPress container:
+
+```bash
+git clone https://github.com/docdyhr/mcp-wordpress.git
+cd mcp-wordpress
+docker build -t mcp-wordpress .
+```
+
+### 2. Run the Docker Container
+
+Start the container with the necessary environment variables:
+
+```bash
+# For Claude Desktop MCP integration (recommended)
+docker run --rm -i \
+  -e WORDPRESS_SITE_URL=https://example.com \
+  -e WORDPRESS_USERNAME=your_username \
+  -e WORDPRESS_APP_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx" \
+  mcp-wordpress
+
+# For debugging/testing (background mode)
+docker run -d --name mcp-wordpress-debug \
+  -e WORDPRESS_SITE_URL=https://example.com \
+  -e WORDPRESS_USERNAME=your_username \
+  -e WORDPRESS_APP_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx" \
+  mcp-wordpress
+```
+
+### 3. Multi-Site Configuration
+
+For multi-site setups, mount a configuration file:
+
+1. Create `mcp-wordpress.config.json`:
+
+```json
+{
+  "sites": [
+    {
+      "id": "site1",
+      "name": "Main Site",
+      "config": {
+        "WORDPRESS_SITE_URL": "https://site1.com",
+        "WORDPRESS_USERNAME": "admin",
+        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
+      }
+    },
+    {
+      "id": "site2",
+      "name": "Blog Site",
+      "config": {
+        "WORDPRESS_SITE_URL": "https://blog.site2.com",
+        "WORDPRESS_USERNAME": "editor",
+        "WORDPRESS_APP_PASSWORD": "yyyy yyyy yyyy yyyy yyyy yyyy"
+      }
+    }
+  ]
+}
+```
+
+2. Run the container with the configuration file:
+
+```bash
+# For Claude Desktop MCP integration (recommended)
+docker run --rm -i \
+  -v $(pwd)/mcp-wordpress.config.json:/app/mcp-wordpress.config.json:ro \
+  mcp-wordpress
+
+# For debugging/testing (background mode)
+docker run -d --name mcp-wordpress-multisite \
+  -v $(pwd)/mcp-wordpress.config.json:/app/mcp-wordpress.config.json:ro \
+  mcp-wordpress
+```
+
+---
+
+## 📦 NPM Setup
+
+### 1. Install Dependencies
+
+Clone the repository and install dependencies:
+
+```bash
+git clone https://github.com/docdyhr/mcp-wordpress.git
+cd mcp-wordpress
+npm install
+```
+
+### 2. Run the Setup Wizard
+
+Run the interactive setup wizard:
+
+```bash
+npm run setup
+```
+
+### 3. Start the Server
+
+Start the MCP WordPress server:
+
+```bash
+npm start
+```
+
+### 4. Test the Tools
+
+Run tests to verify functionality:
+
+```bash
+npm run test:tools
+```
+
+---
+
+## 🖼️ DTX Setup
+
+### 1. Build the DTX Package
+
+Use the provided script to build the DTX package:
+
+```bash
+npm run build
+```
+
+### 2. Deploy the DTX Package
+
+Deploy the DTX package to the appropriate directory:
+
+```bash
+cp -r dxt/ /path/to/dtx/directory
+```
+
+### 3. Verify DTX Integration
+
+Ensure the DTX package is correctly integrated by checking the `manifest.json` file:
+
+```json
+{
+  "name": "MCP WordPress",
+  "version": "1.0.0",
+  "description": "DTX package for MCP WordPress",
+  "main": "index.js"
+}
+```
+
+---
+
+## 🤖 Claude Desktop Configuration
+
+### 1. Update Configuration File
+
+Add the MCP WordPress server to your Claude Desktop configuration file:
+
+```json
+{
+  "mcpServers": {
+    "mcp-wordpress": {
+      "command": "node",
+      "args": ["/path/to/your/mcp-wordpress/dist/index.js"],
+      "env": {
+        "WORDPRESS_SITE_URL": "https://example.com",
+        "WORDPRESS_USERNAME": "your_username",
+        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
+        "WORDPRESS_AUTH_METHOD": "app-password"
+      }
+    }
+  }
+}
+```
+
+### 2. Restart Claude Desktop
+
+Close and reopen Claude Desktop to load the new configuration.
+
+### 3. Test Integration
+
+Use natural language commands in Claude Desktop to interact with your WordPress site:
+
+- "List my WordPress posts"
+- "Show me my site statistics"
+- "What categories do I have?"
+
+---
+
+## 🛠️ Maintenance Commands
+
+### Docker
+
+```bash
+docker ps                # List running containers
+docker logs mcp-wordpress # View container logs
+docker stop mcp-wordpress # Stop the container
+docker rm mcp-wordpress   # Remove the container
+```
+
+### NPM
+
+```bash
+npm run status          # Check WordPress connection
+npm run health          # Full system health check
+npm run verify-claude   # Verify Claude Desktop integration
+```
+
+### DTX
+
+```bash
+npm run build           # Rebuild the DTX package
+```

package/docs/user-guides/DOCKER_SETUP.md

@@ -12,7 +12,7 @@ This guide provides step-by-step instructions for setting up the MCP WordPress s
 docker pull docdyhr/mcp-wordpress:latest
 ```
 
-### 2. Choose Your Setup Method
+### 2. Add to Claude Desktop configuration
 
 ## 🎯 Claude Desktop Integration (Recommended)
 

package/docs/user-guides/DTX_SETUP.md

@@ -111,12 +111,12 @@ The DTX package supports multi-site configuration, but requires manual setup:
 }
 ```
 
-2. **Place the file** in one of these locations:
+2. **Place the file in one of these locations:**
    - **macOS/Linux**: `~/mcp-wordpress.config.json`
    - **Windows**: `%USERPROFILE%\mcp-wordpress.config.json`
    - **DTX Install Directory**: Next to the DTX package files
 
-3. **Skip the DTX configuration** prompts (or enter dummy values)
+3. **Skip the DTX configuration prompts (or enter dummy values)**
 
 4. **Restart Claude Desktop** - the server will detect and use your config file
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-wordpress",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "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",
   "keywords": [
     "mcp",