Phpocalypse

🚀 PHPocalypse-MCP

An MCP server designed for Vibe developers who are busy running tests and static analysis.

🚀 Quick Start

✨ Prerequisites

• You need to have Node.js, npx, and tsx installed.

📦 Installation

• First, clone this repository to a selected directory using git clone.
• Run npm install.
• Next, add the following MCP configuration to your Cursor settings:

{
    "mcpServers": {
        "phpocalypse-mcp": {
            "command": "npx",
            "args": ["tsx", "/Absolute/Path/To/PHPocalypse-MCP/src/index.ts", "--config", "/Absolute/Path/To/Your/PHP/Based/Project/phpocalypse-mcp.yaml"]
        }
    }
}

Please ensure that the paths are correct!

• Create a phpocalypse-mcp.yaml file in your PHP project.

💻 Usage Examples

🔧 Configuration of phpocalypse-mcp.yaml

The structure is quite simple. Define tools by specifying their names and running commands.

tools:
  - name: php-cs-fixer
    command: make php-cs

  - name: php-stan
    command: /vendor/bin/phpstan analyse -c phpstan.neon --memory-limit=-1

  - name: tests-unit
    command: docker compose run --rm php ./vendor/bin/phpunit --testsuite=Unit

  - name: tests-behat
    command: task behat -- --no-interaction

⚠️ Important Note

• This MCP is just a proof-of-concept and may not work properly in all cases. One thing that definitely won't work is any situation that requires interactive CLI input. For example, if Behat is not run in non-interactive mode, it will prompt the user whether to generate missing snippets. Please ensure that your commands simply run and output meaningful content, and leave the rest to your favorite LLM.
• Some large outputs have not been handled correctly. To solve this problem, try using claude-3.7-sonnet or adjust the commands to return less output.