spryker-sdk/ai-dev

AiDev module

0.2.2 2026-01-19 15:37 UTC

Requires

• php: >=8.3
• nikic/php-parser: >=5.0
• php-mcp/server: ^3.3
• spryker/guzzle: >=2.0.0
• spryker/kernel: >=3.30.0
• spryker/module-finder: >=1.0.0
• spryker/oms: >=8.0.0
• spryker/propel-orm: >=1.8.0
• spryker/sales: >=11.0.0
• spryker/symfony: >=3.0.0
• spryker/transfer: >=3.27.0

Requires (Dev)

• phpstan/phpstan: >=1.12.29
• spryker-sdk/phpstan-spryker: >=0.4.3
• spryker/code-sniffer: >=0.17.30
• spryker/development: *

proprietary

README

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.