silverstripe

This Silverstripe MCP server provides real-time validation feedback for SilverStripe 6 PHP code generated by AI assistants. It exposes an ss-validator that analyzes PHP code by parsing it into an abstract syntax tree (AST), runs a suite of plugin-based validators (such as Namespace Validator, BuildTask Validator, and other SS6-specific checks), and returns issues with line numbers and suggested fixes. The goal is to help AI tools iterate toward compliant SilverStripe 6 patterns before code is committed, reducing migration errors between SilverStripe 5 and 6. To use it, configure your MCP client to point at the server’s node entry point, then send PHP code snippets or full files for validation. The server is designed to catch common SS5-to-SS6 migration issues (like outdated imports and BuildTask patterns) and propose SS6-compliant replacements.

Prerequisites:

• Node.js 18+ installed on your system
• Access to install dependencies (npm)
• Optional: PHP environment if you plan to run PHP-based validators locally

Installation steps:

1. Clone the repository and navigate into it git clone https://github.com/sandervanscheepen/silverstripe-mcp cd silverstripe-mcp

2. Install Node.js dependencies npm install

3. Install PHP dependencies (if you want to run PHP validators locally) cd php && composer install && cd ..

4. Build the MCP server (produces dist/index.js) npm run build

5. Start the MCP server (example) npm start

6. Configure your MCP client to connect to the server (see mcp_config in this document).

Tips and considerations:

• The server exposes an ss-validator tool that analyzes PHP code and suggests SS6 migrations for outdated namespaces and BuildTask patterns.
• You can enable all validators via configuration to maximize coverage. See the repository docs for details on per-project tuning.
• Typical env vars (if needed) may include paths to PHP executables or project-specific settings; the default MCP setup in this repository does not require additional env vars unless you customize validators.
• To integrate with clients like Claude Code, add the silverstrike-mcp entry with the node path to dist/index.js, or adapt to your MCP client’s expected command/args format.
• Ensure PHP 8.3+ compatibility on the project side, and verify that PHP-related validators align with your SilverStripe 6 project’s configuration.