Phpocalypse MCP

🚀 PHPocalypse-MCP

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

🚀 Quick Start

✨ Features

This MCP server is tailored for developers who need to run tests and static analysis efficiently. It simplifies the process by providing a unified configuration and execution environment.

📦 Installation

• Prerequisites: You need to have node, npx, and tsx installed.

💻 Usage Examples

1. Clone the repository:
   • First, clone this repository to your selected directory using git clone.
2. Install dependencies:
   • Run npm install in the cloned directory.
3. Configure Cursor:
   • Open your Cursor settings and add the following MCP configuration:

{
    "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"]
        }
    }
}

⚠️ Important Note

Make sure the paths are correct!

4. Create the configuration file:
   • Create a phpocalypse-mcp.yaml file in your PHP project.

📚 Documentation

Configuration in phpocalypse-mcp.yaml

The structure of the phpocalypse-mcp.yaml file is straightforward. You can 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

🔧 Technical Details

This MCP server is a proof - of - concept. There are some limitations:

• Interactive CLI Input: It may not work correctly in scenarios that require interactive CLI input. For example, if behat is not run in non - interactive mode, it will prompt the user to generate missing snippets. Ensure that your commands simply run and output meaningful content, and leave other tasks to your favorite LLM.
• Large Output Handling: Some large outputs are not handled correctly. To address this issue, try using claude - 3.7 - sonnet or adjust the commands to return less content.