mcp-wordpress-datapilot: Instructions file for Claude Code

CLAUDE.md

AI assistant instructions for MCP WordPress project (v2.7.0).

Quick Start

Status: Production-ready | 1237/1248 tests passing (99.1%) | 96%+ coverage | 59 WordPress tools

# Essential Commands
npm test                   # Run tests
npm run dev               # Development mode
npm run health            # System check
npm run fix:rest-auth     # Fix WordPress auth
npm run build             # TypeScript compilation

Architecture

Core: MCP Server (src/index.ts) managing 59 WordPress tools across 10 categories
Client: Composition pattern with dependency injection, 4 auth methods
Tools: Posts(6), Pages(6), Media(5), Users(6), Comments(7), Taxonomies(10), Site(6), Auth(3), Cache(4), Performance(6) Key Files: src/client/WordPressClient.ts, src/tools/, src/config/Config.ts, src/utils/logger.ts

Configuration

Multi-Site (mcp-wordpress.config.json):

{"sites": [{"id": "site1", "config": {"WORDPRESS_SITE_URL": "https://site.com", "WORDPRESS_USERNAME": "user", "WORDPRESS_APP_PASSWORD": "xxxx xxxx"}}]}

Single-Site (.env):

WORDPRESS_SITE_URL=https://site.com
WORDPRESS_USERNAME=user
WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx

Authentication

Methods: App Passwords (recommended), JWT, Basic, API Key

401 Fix: npm run fix:rest-auth or add to .htaccess:

RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule .* - [e=HTTP_AUTHORIZATION:%1]

Troubleshooting

npm run health             # System check
npm run fix:rest-auth      # Fix WordPress 401 errors
DEBUG=true npm run dev     # Debug logging

Common Issues:

• TypeScript: Use | undefined for optional properties
• ESLint: Use _ prefix for unused variables
• WordPress 401: Run npm run fix:rest-auth
• Cache: Clear with rm -rf cache/

CI/CD Pipeline

Automated Release: Conventional commits trigger versioning
Publishing: NPM + Docker Hub
Quality Gates: All tests must pass, security scans clean