Which integrations are available for this server?

Provides pre-commit workflow integration for checking staged PHP files, auto-fixing violations, and re-staging files before commits, with the ability to block commits when coding standard errors are found. Enables automatic [WordPress](/mcp/servers/integrations/wordpress) Coding Standards (WPCS) validation and auto-fixing for WordPress plugins and themes, including pre-commit checks, individual file/directory scanning, and integration with WordPress coding standards rulesets (WordPress-Core, WordPress-Extra, WordPress-Docs).

WPCS MCP Server

A Model Context Protocol (MCP) server that integrates WordPress Coding Standards (WPCS) with Claude AI. This server enables automatic code quality checks and fixes for WordPress plugins and themes before commits.

Features

Pre-commit WPCS validation - Automatically check staged PHP files against WordPress Coding Standards
Auto-fix support - Automatically fix coding standard violations using phpcbf
Block commits on errors - Prevent commits when WPCS errors are found
Claude Code integration - Seamless integration with Claude Code CLI
Multiple check modes - Check individual files, directories, or all staged files

Available Tools

Tool	Description
`wpcs_check_staged`	Check all staged PHP files against WPCS
`wpcs_check_file`	Check a single PHP file
`wpcs_check_directory`	Check all PHP files in a directory
`wpcs_fix_file`	Auto-fix WPCS violations in a file
`wpcs_pre_commit`	Full pre-commit workflow: auto-fix, re-stage, and report

Prerequisites

1. Install PHP CodeSniffer and WordPress Coding Standards

# Install globally via Composer composer global config allow-plugins.dealerdirect/phpcodesniffer-composer-installer true composer global require squizlabs/php_codesniffer wp-coding-standards/wpcs dealerdirect/phpcodesniffer-composer-installer # Add composer bin to PATH (add to ~/.zshrc or ~/.bashrc) export PATH="$HOME/.composer/vendor/bin:$PATH" # Verify installation phpcs -i # Should show: WordPress, WordPress-Core, WordPress-Docs, WordPress-Extra

2. Node.js 18+

Ensure you have Node.js version 18 or higher installed.

Installation

Option 1: Clone and Build

# Clone the repository git clone https://github.com/vapvarun/wpcs-mcp-server.git ~/.mcp-servers/wpcs-mcp-server # Install dependencies cd ~/.mcp-servers/wpcs-mcp-server npm install --include=dev # Build npm run build

Option 2: NPM Install (Coming Soon)

npm install -g wpcs-mcp-server

Configuration

For Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{ "mcpServers": { "wpcs": { "command": "node", "args": [ "/path/to/wpcs-mcp-server/build/index.js" ], "env": { "PATH": "/Users/YOUR_USERNAME/.composer/vendor/bin:/usr/local/bin:/usr/bin:/bin" } } } }

For Claude Code CLI

Add to ~/.claude/settings.json:

{ "permissions": { "allow": [ "mcp__wpcs__wpcs_check_staged", "mcp__wpcs__wpcs_check_file", "mcp__wpcs__wpcs_check_directory", "mcp__wpcs__wpcs_fix_file", "mcp__wpcs__wpcs_pre_commit" ] } }

Pre-commit Hook (Optional)

Create ~/.claude/hooks/wpcs-pre-commit.sh:

#!/bin/bash export PATH="$HOME/.composer/vendor/bin:$PATH" # Get staged PHP files STAGED_PHP=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.php$' || true) if [ -z "$STAGED_PHP" ]; then exit 0 fi # Check each file TOTAL_ERRORS=0 for file in $STAGED_PHP; do if [ -f "$file" ]; then RESULT=$(phpcs --standard=WordPress --report=json "$file" 2>/dev/null || true) FILE_ERRORS=$(echo "$RESULT" | grep -o '"errors":[0-9]*' | head -1 | grep -o '[0-9]*' || echo "0") if [ "$FILE_ERRORS" -gt 0 ] 2>/dev/null; then TOTAL_ERRORS=$((TOTAL_ERRORS + FILE_ERRORS)) fi fi done if [ "$TOTAL_ERRORS" -gt 0 ]; then echo "WPCS ERROR: Found $TOTAL_ERRORS coding standard error(s)" echo "Run: wpcs_pre_commit to fix" exit 2 fi exit 0

Then add to ~/.claude/settings.json:

{ "hooks": { "PreToolUse": [ { "matcher": "Bash(git commit*)", "hooks": [ { "type": "command", "command": "bash \"$HOME/.claude/hooks/wpcs-pre-commit.sh\"" } ] } ] } }

Usage

With Claude

Simply ask Claude to check your WordPress code:

"Check my staged files for WPCS violations" "Run wpcs_pre_commit before I commit" "Fix WPCS issues in includes/class-my-plugin.php" "Check the entire src/ directory for coding standards"

Example Workflow

Make changes to your WordPress plugin/theme
Stage your changes: git add .
Ask Claude: "Run wpcs_pre_commit"
Claude will:
- Auto-fix what can be fixed
- Re-stage the fixed files
- Report any remaining issues
If no errors, commit proceeds; otherwise, fix remaining issues

Tool Details

wpcs_pre_commit

The most commonly used tool. It performs a complete pre-commit workflow:

Input: - working_dir (optional): Git repository root - auto_stage (optional): Re-stage fixed files (default: true) Output: - PRE-COMMIT: PASSED or PRE-COMMIT: BLOCKED - List of auto-fixed files - Remaining issues with line numbers

wpcs_check_file

Check a single PHP file:

Input: - file_path (required): Path to PHP file - working_dir (optional): Working directory Output: - Errors and warnings with line/column numbers - Source of each violation - Whether each issue is auto-fixable

wpcs_fix_file

Auto-fix a single file:

Input: - file_path (required): Path to PHP file - working_dir (optional): Working directory Output: - Confirmation of fixes applied - Remaining issues that couldn't be auto-fixed

WordPress Coding Standards

This server uses the WordPress ruleset which includes:

WordPress-Core - Essential WordPress coding standards
WordPress-Extra - Additional best practices
WordPress-Docs - Documentation standards

Development

# Clone git clone https://github.com/vapvarun/wpcs-mcp-server.git cd wpcs-mcp-server # Install dependencies npm install --include=dev # Build npm run build # Watch mode npm run dev

Troubleshooting

phpcs not found

Ensure composer bin is in your PATH:

export PATH="$HOME/.composer/vendor/bin:$PATH"

Add this to your shell profile (~/.zshrc or ~/.bashrc).

WordPress standard not found

Reinstall WPCS:

composer global require wp-coding-standards/wpcs phpcs -i # Verify WordPress is listed

MCP server not loading

Check the path in your config is correct
Ensure the server is built: npm run build
Restart Claude Desktop or Claude Code

License

GPL-2.0-or-later

Author

Varun Dubey (@vapvarun)

Website: wbcomdesigns.com
Email: varun@wbcomdesigns.com

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

WPCS MCP Server

WPCS MCP Server

Features

Available Tools

Prerequisites

1. Install PHP CodeSniffer and WordPress Coding Standards

2. Node.js 18+

Installation

Option 1: Clone and Build

Option 2: NPM Install (Coming Soon)

Configuration

For Claude Desktop

For Claude Code CLI

Pre-commit Hook (Optional)

Usage

With Claude

Example Workflow

Tool Details

wpcs_pre_commit

wpcs_check_file

wpcs_fix_file

WordPress Coding Standards

Development

Troubleshooting

phpcs not found

WordPress standard not found

MCP server not loading

License

Author

Contributing

Acknowledgments

Resources

New MCP Servers

Latest Blog Posts

MCP directory API