AiDev Module

Experimental Module: This module is experimental and not stable. There is no backward compatibility promise.

Connect your Spryker application to AI assistants through the Model Context Protocol (MCP).

Installation

composer require spryker-sdk/ai-dev --dev
docker/sdk console transfer:generate

Register the console commands in your ConsoleDependencyProvider:

use SprykerSdk\Zed\AiDev\Communication\Console\GeneratePromptsConsole;
use SprykerSdk\Zed\AiDev\Communication\Console\McpServerConsole;

protected function getConsoleCommands(Container $container): array
{
       if (class_exists(GeneratePromptsConsole::class)) {
           $commands[] = new GeneratePromptsConsole();
       }

       if (class_exists(McpServerConsole::class)) {
           $commands[] = new McpServerConsole();
       }
}

Quick Start

Connect to AI assistants:

Claude Code

claude mcp add spryker-project "$(pwd)/docker/sdk console ai-dev:mcp-server -q"

Claude Desktop - Add to claude_desktop_config.json:

{
  "mcpServers": {
    "spryker-ai-dev": {
      "command": "/path/to/your/project/docker/sdk",
      "args": ["console", "ai-dev:mcp-server", "-q"]
    }
  }
}

Prompts

Prompts are auto-generated from the Spryker Prompt Library on first run. To regenerate:

docker/sdk console ai-dev:generate-prompts

Documentation

For detailed setup, configuration, and extension points:

• AI Dev Overview
• MCP Server Configuration

Debugging

Use MCP Inspector to test your MCP server:

npx @modelcontextprotocol/inspector docker/sdk console ai-dev:mcp-server -q

Contribution

We welcome contributions to improve this experimental module.

How to Contribute

1. Fork the repository
2. Create a feature branch
3. Make your changes following Spryker coding standards
4. Submit a pull request with a clear description of your changes

Reporting Issues

Please report issues through the GitHub issue tracker with:

• Clear description of the problem
• Steps to reproduce
• Expected vs actual behavior
• Environment details (PHP version, Spryker version, etc.)

Development

Prerequisites

• Docker SDK ^1.71.0
• PHP ^8.3

Setup for Development

composer install
vendor/bin/phpstan analyze
vendor/bin/phpcs --standard=phpcs.xml

License

This module is released under the Spryker Evaluation License Agreement. See LICENSE file for details.