PHPocalypse-MCP
About
MCP server for vibe developers that are too busy to run tests and static analysis.
Details
- Author
- plapinski
- Downloads
- 174
- Categories
- Other
Jump to
- 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.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
PHPocalypse-MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"phpocalypse-mcp": {
"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"
]
}
}
}
}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
MCP server for vibe developers that are too busy to run tests and static analysis.Prerequisites
- You need to have node, npx and tsx installedHow to
- First,git clone this repo to chosen directory
- Run npm install
- Next, open your Cursor settings and add the following MCP config:
{
"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"]
}
}
}
- In your PHP project, create phpocalypse-mcp.yaml file
phpocalypse-mcp.yaml config
The structure is straightforward. Define the tools by giving them a name and a command to run.
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
Caveats
- This MCP is just a proof of concept and it may not work in every case. One thing that will not work for sure is any interactive CLI input. A good example is behat, that - if not run in non-inteartvice mode - will prompt user with a question of whether to generate missing snippets. Make sure that your commands just run and output something meaningful and leave the rest to your favourite LLM. - Some bigger outputs are not handler correctly yet. To fix that, try to either useclaude-3.7-sonnet or craft your commands to return less.Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
