PHPocalypse MCP Server

@plapinski

Basic information

About PHPocalypse MCP Server

MCP server for vibe developers that are too busy to run tests and static analysis.

PHPocalypse MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

PHPocalypse MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is PHPocalypse-MCP?

PHPocalypse-MCP is an MCP (Model Context Protocol) server that lets LLM-powered coding tools execute PHP development commands—such as static analysis, code style fixes, and test suites—by running user-defined commands from a YAML configuration file. It is aimed at developers who want to delegate running PHP tools to their AI assistant.

How to use PHPocalypse-MCP?

Clone the repository, run npm install, and add an MCP server entry in your Cursor settings (or other MCP-compatible editor). The entry points npx tsx at src/index.ts with a --config argument pointing to a phpocalypse-mcp.yaml file in your PHP project. Then create that YAML file and define the tools you want the LLM to invoke (e.g., php-cs-fixer, phpstan, tests-unit).

Key features of PHPocalypse-MCP

Define PHP tools by name and shell command in a YAML config.
Works with any PHP project structure.
Supports arbitrary commands (e.g., make, docker compose, vendor/bin/*).
Intended for non-interactive CLI output.
Proof-of-concept; interactive prompts are not supported.

Use cases of PHPocalypse-MCP

Run PHPStan static analysis from an AI chat without leaving the editor.
Execute PHP-CS-Fixer code style corrections on demand.
Run both unit and Behat test suites via a single LLM command.
Automate quality checks without manual terminal switching.

Frequently asked questions

What prerequisites are needed?

You need Node.js, npx, and tsx installed on your system.

How do I define tools in the YAML config?

Create a `phpocalypse-mcp.yaml` file with a `tools` array, each entry requiring a `name` and a `command` string. Example tools: php-cs-fixer, phpstan, tests-unit, tests-behat.

What will not work with this MCP server?

Any interactive CLI input will not work. For example, Behat prompts for snippet generation must be run in non-interactive mode (using `--no-interaction` or similar flags).

Are there known limitations?

Yes. Larger command outputs are not handled correctly yet. To work around this, try using `claude-3.7-sonnet` as the LLM or craft your commands to produce shorter, meaningful output.

Does the server support authentication or multiple transport types?

The README only describes a local stdio-based transport (via `npx` command). No authentication details are mentioned.

Comments

More Other MCP servers

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

ICSS

chokcoco

不止于 CSS

20.7K