mcp-wordpress 1.5.2 → 2.0.0

package/docs/integrations/vs-code.md

@@ -0,0 +1,515 @@
+# VS Code Integration Guide
+
+**Complete guide to integrating WordPress MCP Server with VS Code and related tools**
+
+## Table of Contents
+
+- [Cline Integration](#cline-integration)
+- [GitHub Copilot Integration](#github-copilot-integration)
+- [Continue Integration](#continue-integration)
+- [VS Code Extensions](#vs-code-extensions)
+- [Troubleshooting](#troubleshooting)
+
+## Cline Integration
+
+### Overview
+
+[Cline](https://github.com/cline/cline) is a VS Code extension that brings AI assistance directly to your editor.
+It supports MCP servers for extended functionality.
+
+### Installation
+
+1. **Install Cline Extension**
+
+   ```bash
+   # Install from VS Code Marketplace
+   code --install-extension cline.cline
+   ```
+
+2. **Configure MCP Server**
+
+   Open Cline settings and add MCP server configuration:
+
+   ```json
+   {
+     "cline.mcpServers": {
+       "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"
+         }
+       }
+     }
+   }
+   ```
+
+### Usage Examples
+
+**Content Creation Workflow:**
+
+```text
+🧑‍💻 You: "Create a new WordPress post about VS Code productivity tips"
+🤖 Cline: "I'll create a new post for you using the WordPress MCP server..."
+         [Uses wp_create_post with generated content]
+```
+
+**Site Management:**
+
+```text
+🧑‍💻 You: "Check my WordPress site stats and list recent posts"
+🤖 Cline: "Let me check your site statistics and recent posts..."
+         [Uses wp_get_site_settings and wp_list_posts]
+```
+
+**Media Management:**
+
+```text
+🧑‍💻 You: "Upload this image to WordPress and create a gallery post"
+🤖 Cline: "I'll upload the image and create a gallery post..."
+         [Uses wp_upload_media and wp_create_post]
+```
+
+### Advanced Configuration
+
+**Multi-Site Setup:**
+
+```json
+{
+  "cline.mcpServers": {
+    "wordpress-main": {
+      "command": "npx",
+      "args": ["-y", "mcp-wordpress"],
+      "env": {
+        "WORDPRESS_SITE_URL": "https://main-site.com",
+        "WORDPRESS_USERNAME": "admin",
+        "WORDPRESS_APP_PASSWORD": "xxxx-xxxx-xxxx-xxxx"
+      }
+    },
+    "wordpress-blog": {
+      "command": "npx",
+      "args": ["-y", "mcp-wordpress"],
+      "env": {
+        "WORDPRESS_SITE_URL": "https://blog.example.com",
+        "WORDPRESS_USERNAME": "editor",
+        "WORDPRESS_APP_PASSWORD": "yyyy-yyyy-yyyy-yyyy"
+      }
+    }
+  }
+}
+```
+
+**Performance Optimization:**
+
+```json
+{
+  "cline.mcpServers": {
+    "wordpress": {
+      "command": "node",
+      "args": ["./node_modules/mcp-wordpress/dist/index.js"],
+      "env": {
+        "WORDPRESS_SITE_URL": "https://your-site.com",
+        "WORDPRESS_USERNAME": "your-username",
+        "WORDPRESS_APP_PASSWORD": "your-app-password",
+        "MCP_CACHE_ENABLED": "true",
+        "MCP_PERFORMANCE_MODE": "true"
+      }
+    }
+  }
+}
+```
+
+## GitHub Copilot Integration
+
+### Copilot Overview
+
+GitHub Copilot can work with MCP servers through workspace configuration and custom prompts.
+
+### Setup
+
+1. **Install GitHub Copilot Extension**
+
+   ```bash
+   code --install-extension github.copilot
+   ```
+
+2. **Create Workspace Configuration**
+
+   Create `.vscode/settings.json` in your project:
+
+   ```json
+   {
+     "copilot.workspace.mcpServers": {
+       "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"
+         }
+       }
+     }
+   }
+   ```
+
+3. **Configure Custom Prompts**
+
+   Create `.vscode/copilot-prompts.json`:
+
+   ```json
+   {
+     "wordpress-post": {
+       "description": "Create WordPress post with MCP",
+       "prompt": "Use the WordPress MCP server to create a new post with the following details: {{title}}, {{content}}, {{status}}"
+     },
+     "wordpress-site-check": {
+       "description": "Check WordPress site status",
+       "prompt": "Use the WordPress MCP server to check site status, list recent posts, and provide a summary"
+     }
+   }
+   ```
+
+### Usage Patterns
+
+**Code Generation with WordPress Context:**
+
+```typescript
+// Copilot will suggest WordPress-aware code
+const createPost = async (title: string, content: string) => {
+  // @copilot: Use WordPress MCP server to create post
+  const result = await mcpClient.call('wp_create_post', {
+    title,
+    content,
+    status: 'publish'
+  });
+  return result;
+};
+```
+
+**Content Management Scripts:**
+
+```typescript
+// @copilot: Generate WordPress content management script
+import { WordPressMCP } from 'mcp-wordpress';
+
+const managePosts = async () => {
+  // Copilot will suggest WordPress-specific operations
+  const posts = await wordpress.listPosts({ status: 'draft' });
+  // Process draft posts...
+};
+```
+
+## Continue Integration
+
+### Continue Overview
+
+[Continue](https://continue.dev/) is an open-source VS Code extension for AI-powered coding assistance.
+
+### Installation & Setup
+
+1. **Install Continue Extension**
+
+   ```bash
+   code --install-extension continue.continue
+   ```
+
+2. **Configure MCP Server**
+
+   Edit `~/.continue/config.json`:
+
+   ```json
+   {
+     "mcpServers": {
+       "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"
+         },
+         "timeout": 30000
+       }
+     },
+     "contextProviders": [
+       {
+         "name": "wordpress",
+         "params": {
+           "serverName": "wordpress"
+         }
+       }
+     ]
+   }
+   ```
+
+### Continue Usage Examples
+
+**WordPress Development Workflow:**
+
+```text
+/wordpress What are my recent posts?
+/wordpress Create a new post about "AI in web development"
+/wordpress Check my site performance metrics
+/wordpress List all users with editor role
+```
+
+**Content Creation:**
+
+```text
+/wordpress Generate a blog post about TypeScript best practices and publish it as a draft
+/wordpress Upload an image from my desktop and create a photo gallery post
+/wordpress Search for all posts containing "tutorial" and provide a summary
+```
+
+**Site Management:**
+
+```text
+/wordpress Check my WordPress site health and security status
+/wordpress List all plugins and their versions
+/wordpress Create a backup of my site content
+/wordpress Optimize my site performance settings
+```
+
+## VS Code Extensions
+
+### Recommended Extensions
+
+**Essential Extensions:**
+
+- **WordPress Snippets** - Code snippets for WordPress development
+- **PHP Intelephense** - PHP language support
+- **REST Client** - Test WordPress REST API endpoints
+- **GitLens** - Git integration for version control
+
+**MCP-Compatible Extensions:**
+
+- **Cline** - AI assistant with MCP support
+- **Continue** - Open-source AI coding assistant
+- **GitHub Copilot** - AI-powered code completion
+- **Tabnine** - AI code completion
+
+### Configuration
+
+**Create workspace settings (`.vscode/settings.json`):**
+
+```json
+{
+  "php.validate.executablePath": "/usr/bin/php",
+  "wordpress.path": "/path/to/wordpress",
+  "rest-client.environmentVariables": {
+    "wordpress": {
+      "baseUrl": "https://your-site.com",
+      "username": "your-username",
+      "password": "your-app-password"
+    }
+  },
+  "cline.mcpServers": {
+    "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"
+      }
+    }
+  }
+}
+```
+
+**Create tasks (`.vscode/tasks.json`):**
+
+```json
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "WordPress: Test Connection",
+      "type": "shell",
+      "command": "npx",
+      "args": ["mcp-wordpress", "test-auth"],
+      "group": "test",
+      "presentation": {
+        "echo": true,
+        "reveal": "always",
+        "focus": false,
+        "panel": "shared"
+      }
+    },
+    {
+      "label": "WordPress: List Recent Posts",
+      "type": "shell",
+      "command": "npx",
+      "args": ["mcp-wordpress", "list-posts", "--per_page=10"],
+      "group": "build"
+    }
+  ]
+}
+```
+
+## Troubleshooting
+
+### Common Issues
+
+**1. MCP Server Not Starting**
+
+```bash
+# Check if MCP server is accessible
+npx mcp-wordpress --version
+
+# Test connection manually
+npx mcp-wordpress wp_test_auth
+```
+
+**2. Authentication Failures**
+
+```bash
+# Verify credentials
+curl -u username:app-password https://your-site.com/wp-json/wp/v2/users/me
+
+# Check application password format
+# ✅ Correct: xxxx-xxxx-xxxx-xxxx
+# ❌ Wrong: "xxxx-xxxx-xxxx-xxxx" (no quotes)
+```
+
+**3. Extension Configuration Issues**
+
+```json
+// Check extension settings
+{
+  "cline.debug": true,
+  "cline.logLevel": "debug",
+  "continue.telemetryEnabled": false
+}
+```
+
+### Debug Mode
+
+**Enable debug logging:**
+
+```bash
+# Set environment variable
+export DEBUG=mcp-wordpress:*
+
+# Run with debug output
+npx mcp-wordpress wp_test_auth
+```
+
+**VS Code debugging:**
+
+```json
+{
+  "launch": {
+    "version": "0.2.0",
+    "configurations": [
+      {
+        "name": "Debug MCP WordPress",
+        "type": "node",
+        "request": "launch",
+        "program": "${workspaceFolder}/node_modules/mcp-wordpress/dist/index.js",
+        "env": {
+          "DEBUG": "mcp-wordpress:*",
+          "WORDPRESS_SITE_URL": "https://your-site.com",
+          "WORDPRESS_USERNAME": "your-username",
+          "WORDPRESS_APP_PASSWORD": "your-app-password"
+        }
+      }
+    ]
+  }
+}
+```
+
+### Performance Optimization
+
+**Optimize MCP server performance:**
+
+```json
+{
+  "cline.mcpServers": {
+    "wordpress": {
+      "command": "node",
+      "args": ["./node_modules/mcp-wordpress/dist/index.js"],
+      "env": {
+        "WORDPRESS_SITE_URL": "https://your-site.com",
+        "WORDPRESS_USERNAME": "your-username",
+        "WORDPRESS_APP_PASSWORD": "your-app-password",
+        "MCP_CACHE_TTL": "300",
+        "MCP_REQUEST_TIMEOUT": "30000",
+        "MCP_MAX_CONNECTIONS": "10"
+      }
+    }
+  }
+}
+```
+
+**Reduce extension overhead:**
+
+```json
+{
+  "cline.autoStart": false,
+  "cline.maxConcurrentRequests": 3,
+  "continue.maxConcurrentRequests": 2
+}
+```
+
+## Best Practices
+
+### Security
+
+- Never commit credentials to version control
+- Use environment variables for sensitive data
+- Regularly rotate WordPress application passwords
+- Enable HTTPS for all WordPress connections
+
+### Performance
+
+- Use caching for frequently accessed data
+- Implement connection pooling
+- Set appropriate timeouts
+- Monitor resource usage
+
+### Development Workflow
+
+- Use version control for configuration files
+- Test integrations in development environment
+- Document custom prompts and workflows
+- Keep extensions updated
+
+### Collaboration
+
+- Share workspace configuration with team
+- Document custom MCP server configurations
+- Use consistent naming conventions
+- Maintain integration documentation
+
+---
+
+## Resources
+
+### Documentation
+
+- [Cline Documentation](https://github.com/cline/cline/wiki)
+- [Continue Documentation](https://continue.dev/docs)
+- [GitHub Copilot Documentation](https://docs.github.com/copilot)
+- [VS Code Extension API](https://code.visualstudio.com/api)
+
+### Community
+
+- [WordPress MCP Server Discussions](https://github.com/docdyhr/mcp-wordpress/discussions)
+- [VS Code Community](https://github.com/microsoft/vscode/discussions)
+- [MCP Protocol Discussions](https://github.com/modelcontextprotocol/protocol/discussions)
+
+### Support
+
+- GitHub Issues: [Report integration problems](https://github.com/docdyhr/mcp-wordpress/issues)
+- Email Support: <support@example.com>
+- Community Forum: [WordPress MCP Community](https://community.example.com)
+
+---
+
+*This guide is regularly updated. Last updated: 2024-01-15*
+
+*For VS Code integration questions, visit our [GitHub Discussions](https://github.com/docdyhr/mcp-wordpress/discussions)*

package/docs/releases/COMMUNITY_ANNOUNCEMENT_v1.1.2.md

@@ -6,11 +6,13 @@
 
 Hey WordPress community! 👋
 
-I'm excited to share that we've just released **MCP WordPress v1.1.2**, featuring a major technical debt refactoring that achieved a **94% reduction in our core API module** (from 1,043 lines to just 59 lines)!
+I'm excited to share that we've just released **MCP WordPress v1.1.2**, featuring a major technical debt refactoring
+that achieved a **94% reduction in our core API module** (from 1,043 lines to just 59 lines)!
 
 ### What is MCP WordPress?
 
-It's a Model Context Protocol server that provides 54 tools for managing WordPress sites through the REST API. Perfect for automation, AI assistants, and developers who want programmatic WordPress control.
+It's a Model Context Protocol server that provides 54 tools for managing WordPress sites through the REST API. Perfect
+for automation, AI assistants, and developers who want programmatic WordPress control.
 
 ### What's New in v1.1.2?
 
@@ -32,8 +34,7 @@ npx mcp-wordpress
 - [Docker Setup](../user-guides/DOCKER_SETUP.md) - Containerized deployment
 - [DTX Setup](../user-guides/DTX_SETUP.md) - Desktop Extension
 
-**GitHub**: <https://github.com/docdyhr/mcp-wordpress>
-**NPM**: <https://www.npmjs.com/package/mcp-wordpress>
+**GitHub**: <https://github.com/docdyhr/mcp-wordpress> **NPM**: <https://www.npmjs.com/package/mcp-wordpress>
 
 Would love your feedback and contributions! 🚀
 
@@ -43,16 +44,16 @@ Would love your feedback and contributions! 🚀
 
 🎉 Just released MCP WordPress v1.1.2!
 
-Major achievement: 94% code reduction through modular refactoring (1043→59 lines) while maintaining 100% backward compatibility.
+Major achievement: 94% code reduction through modular refactoring (1043→59 lines) while maintaining 100% backward
+compatibility.
 
-✅ 95%+ test coverage
-🏗️ Clean architecture
-⚡ Better performance
-🔐 Multi-site support
+✅ 95%+ test coverage 🏗️ Clean architecture ⚡ Better performance 🔐 Multi-site support
 
 Try it: npx mcp-wordpress
 
-# WordPress #TypeScript #OpenSource
+## Tags
+
+WordPress #TypeScript #OpenSource
 
 ---
 
@@ -60,33 +61,38 @@ Try it: npx mcp-wordpress
 
 **Excited to announce MCP WordPress v1.1.2 - A Technical Debt Success Story**
 
-We've just completed a major refactoring that reduced our core API module by 94% (from 1,043 to 59 lines) while maintaining 100% backward compatibility.
+We've just completed a major refactoring that reduced our core API module by 94% (from 1,043 to 59 lines) while
+maintaining 100% backward compatibility.
 
-Key achievements:
-• Modular manager-based architecture
-• 95%+ test coverage across all functionality
-• Standardized error handling patterns
-• Improved performance and memory management
+Key achievements: • Modular manager-based architecture • 95%+ test coverage across all functionality • Standardized
+error handling patterns • Improved performance and memory management
 
-This release demonstrates how technical debt can be addressed systematically without disrupting users. The refactoring sets a solid foundation for future features while making the codebase more maintainable and contributor-friendly.
+This release demonstrates how technical debt can be addressed systematically without disrupting users. The refactoring
+sets a solid foundation for future features while making the codebase more maintainable and contributor-friendly.
 
-MCP WordPress provides 54 tools for managing WordPress sites programmatically, supporting multi-site configurations and multiple authentication methods.
+MCP WordPress provides 54 tools for managing WordPress sites programmatically, supporting multi-site configurations and
+multiple authentication methods.
 
 Try it today: <https://www.npmjs.com/package/mcp-wordpress>
 
-# SoftwareEngineering #OpenSource #WordPress #TypeScript #TechnicalDebt
+## LinkedIn Tags
+
+SoftwareEngineering #OpenSource #WordPress #TypeScript #TechnicalDebt
 
 ---
 
 ## For Dev.to / Medium Article Intro
 
-# How We Achieved 94% Code Reduction: MCP WordPress v1.1.2 Refactoring Story
+## How We Achieved 94% Code Reduction: MCP WordPress v1.1.2 Refactoring Story
 
-When we looked at our 1,043-line monolithic API client, we knew it was time for change. Today, I'm excited to share how we transformed MCP WordPress through systematic refactoring, achieving dramatic improvements while maintaining complete backward compatibility.
+When we looked at our 1,043-line monolithic API client, we knew it was time for change. Today, I'm excited to share how
+we transformed MCP WordPress through systematic refactoring, achieving dramatic improvements while maintaining complete
+backward compatibility.
 
 ## The Challenge
 
-Our `api.ts` file had grown organically to over 1,000 lines, violating multiple SOLID principles and making maintenance increasingly difficult. The technical debt was clear:
+Our `api.ts` file had grown organically to over 1,000 lines, violating multiple SOLID principles and making maintenance
+increasingly difficult. The technical debt was clear:
 
 - Single file handling authentication, requests, and business logic
 - Repetitive error handling patterns (49 try-catch blocks!)
@@ -138,6 +144,7 @@ Installation:
 npx mcp-wordpress
 ```
 
-Check out the modular architecture that makes it easy to extend and maintain. Would love feedback from the Claude community on how you're using it!
+Check out the modular architecture that makes it easy to extend and maintain. Would love feedback from the Claude
+community on how you're using it!
 
 GitHub: <https://github.com/docdyhr/mcp-wordpress>

package/docs/releases/RELEASE_NOTES_v1.1.2.md

@@ -2,7 +2,8 @@
 
 ## 🏆 Major Technical Debt Refactoring Achievement
 
-We're excited to announce **v1.1.2**, a major milestone featuring comprehensive technical debt refactoring that dramatically improves code maintainability while preserving 100% backward compatibility.
+We're excited to announce **v1.1.2**, a major milestone featuring comprehensive technical debt refactoring that
+dramatically improves code maintainability while preserving 100% backward compatibility.
 
 ---
 
@@ -152,9 +153,11 @@ We're excited to announce **v1.1.2**, a major milestone featuring comprehensive
 
 ## 🙏 Acknowledgments
 
-This refactoring represents months of careful planning and implementation, ensuring that we could dramatically improve the codebase while maintaining complete compatibility for our users.
+This refactoring represents months of careful planning and implementation, ensuring that we could dramatically improve
+the codebase while maintaining complete compatibility for our users.
 
-**Special thanks to all community members** who have been using and testing the WordPress MCP server, providing valuable feedback that guided this refactoring effort.
+**Special thanks to all community members** who have been using and testing the WordPress MCP server, providing valuable
+feedback that guided this refactoring effort.
 
 ---
 
@@ -194,6 +197,4 @@ npm update -g mcp-wordpress
 
 **🤖 Generated with [Claude Code](https://claude.ai/code)**
 
-_Release Date: June 29, 2025_
-_Version: 1.1.2_
-_Codename: "Modular Foundation"_
+_Release Date: June 29, 2025_ _Version: 1.1.2_ _Codename: "Modular Foundation"_

package/docs/testing-configurations.md

@@ -0,0 +1,11 @@
+# Jest Configuration Documentation
+
+This project uses multiple Jest configurations for different testing scenarios:
+
+- **jest.config.cjs**: Main Jest configuration (default)
+- **jest.typescript.config.json**: TypeScript test configuration (used by npm test)
+- **jest.ci.config.json**: CI-specific configuration with limited test scope
+- **jest.test-env.config.json**: Environment testing configuration
+- **jest.vscode.config.json**: VS Code integration configuration
+
+Each configuration serves a specific purpose and is optimized for its use case.

package/docs/user-guides/DOCKER_NPM_DTX_SETUP.md

@@ -1,6 +1,7 @@
 # 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.
+This guide provides step-by-step instructions for setting up the MCP WordPress server using Docker, NPM, and DTX,
+including Claude Desktop configuration.
 
 ---
 
@@ -67,7 +68,7 @@ For multi-site setups, mount a configuration file:
 }
 ```
 
-2. Run the container with the configuration file:
+1. Run the container with the configuration file:
 
 ```bash
 # For Claude Desktop MCP integration (recommended)

package/docs/user-guides/DOCKER_SETUP.md

@@ -1,6 +1,7 @@
 # Docker Setup Guide
 
-This guide provides step-by-step instructions for setting up the MCP WordPress server using Docker, specifically for Claude Desktop integration.
+This guide provides step-by-step instructions for setting up the MCP WordPress server using Docker, specifically for
+Claude Desktop integration.
 
 ---
 
@@ -71,7 +72,7 @@ Add this to your Claude Desktop configuration file (`~/Library/Application Suppo
 }
 ```
 
-2. **Add to Claude Desktop configuration**:
+1. **Add to Claude Desktop configuration**:
 
 ```json
 {