v0.5.0 — V2 Architecture

What's New

Upgrade to V2 architecture — the last of 8 CrunchTools MCP servers to reach V2 standard.

Governance Infrastructure

• AGPL-3.0 LICENSE
• .specify/ project governance (constitution, baseline spec, templates)
• Gourmand AI slop detection config
• Pre-commit hooks (ruff check + format)
• GitHub issue templates (bug report, feature request)

Testing

• 85 tests (up from ~40)
• Full mocked API tests for all 30 tools across 5 categories
• Shared test fixtures in conftest.py

Version Sync

• All 4 version locations synced to 0.5.0

No Breaking Changes

• Same 30 tools, same wordpress_ prefix, same env vars

v0.2.1

What's Changed

Improved media upload experience for container deployments

• Better error messages: File-not-found errors now explain the container mount path requirement (/tmp/mcp-uploads/)
• Updated tool description: wordpress_upload_media includes a CONTAINER NOTE about the filesystem boundary
• Server instructions updated: Mount path info is now surfaced to MCP clients on connection
• New tests: Added test_media.py with tests for file upload validation

Fixes #2

v0.2.0

What's Changed

Bug Fixes

• Fix media uploads locking up Claude Code — Changed upload_media to accept a file path instead of base64-encoded data, eliminating multi-MB payloads over MCP stdio (#1)
• Fix multipart upload Content-Type — Removed default Content-Type: application/json header from the HTTP client that was leaking into file uploads and causing WordPress to reject them

Breaking Changes

• wordpress_upload_media now takes file_path (absolute path on disk) instead of file_data (base64 string) and filename. The MCP server container must have the upload directory mounted (e.g., -v /tmp/mcp-uploads:/tmp/mcp-uploads:Z).

Full Changelog: v0.1.0...v0.2.0

v0.1.0 - Initial Release

Initial Release

Secure MCP server for WordPress content management.

Features

• 30 tools for posts, pages, media, and comments
• Security-focused: Credentials protected, input validation, SSRF prevention
• Developer workflow: Scheduled publishing, revisions, search

Installation

# With uvx
uvx mcp-wordpress-crunchtools

# With pip
pip install mcp-wordpress-crunchtools

Usage with Claude Code

claude mcp add mcp-wordpress-crunchtools \
  --env WORDPRESS_URL=https://example.com \
  --env WORDPRESS_USERNAME=admin \
  --env WORDPRESS_APP_PASSWORD='xxxx xxxx xxxx xxxx' \
  -- uvx mcp-wordpress-crunchtools

Container

podman pull quay.io/crunchtools/mcp-wordpress:latest