MCP Phpstan Server

🚀 MCP PHPStan Server (Local, No Dependencies)

A minimal Model Context Protocol (MCP) server implemented in pure PHP, offering two tools for PHP code analysis.

This MCP server, written entirely in PHP, provides access to two useful tools:

• phpstan_analyze: Executes PHPStan and returns a human - readable report.
• phpstan_pro: Runs PHPStan Pro to generate JSON output (if available) for more detailed diagnostics.

It has no Composer dependencies and can be easily copied into any project.

✨ Features

Structure (DDD)

• src/Domain: Contains tool contracts and result definitions.
• src/Application: Implements the JSON - RPC MCP server and the tool registry.
• src/Infrastructure: Includes the process runner, configuration management, and tool implementations.
• bin/mcp-phpstan: Serves as the STDIO entrypoint.

Configure

You can configure the server through environment variables or the config/config.json file:

• MCP_PHPSTAN_PATH: Specifies the path to the phpstan binary. The default is vendor/bin/phpstan, and it will also search for phpstan in the system PATH.
• MCP_PHPSTAN_CONFIG: Points to a phpstan.neon or phpstan.neon.dist file (optional; it will be autodetected upwards).
• MCP_PHPSTAN_LEVEL: Defines the analysis level to pass to PHPStan (e.g., max or 8) if not set in the config.

If no configuration is provided, the server will search upwards from the current working directory for phpstan.neon or phpstan.neon.dist.

Run

First, make the script executable:

chmod +x mcp/phpstan-server/bin/mcp-phpstan

Then, configure your MCP client to start the server via stdio using the following command:

/absolute/path/to/mcp/phpstan-server/bin/mcp-phpstan

Example: Claude Desktop config

{
  "mcpServers": {
    "phpstan": {
      "command": "/absolute/path/to/mcp/phpstan-server/bin/mcp-phpstan",
      "env": {
        "MCP_PHPSTAN_PATH": "/usr/local/bin/phpstan",
        "MCP_PHPSTAN_CONFIG": "/path/to/your/phpstan.neon",
        "MCP_PHPSTAN_LEVEL": "max"
      }
    }
  }
}

The server communicates using JSON - RPC 2.0 over STDIN/STDOUT and supports the following methods:

• initialize
• tools/list
• tools/call

Tools

phpstan_analyze

Input schema:

{
  "type": "object",
  "properties": {
    "paths": {"type": "array", "items": {"type": "string"}},
    "level": {"type": ["string", "integer"], "description": "Override level"}
  },
  "required": ["paths"]
}

phpstan_pro

It uses the same input schema as phpstan_analyze but returns JSON directly when possible.

Notes

⚠️ Important Note

Output to STDOUT is strictly JSON - RPC messages, while logs are sent to STDERR. Non - zero exit codes from phpstan may indicate either findings or failures; the server parses the output to determine the error state.