symfony/ai-mate Example Project

Example Symfony 8.0 project demonstrating MCP server integration for PHP development

What is this?

Demonstrates the symfony/ai-mate MCP server integration with:

• 5 Tools: php-version, operating-system, operating-system-family, php-extensions, test_tool
• 2 Static Resources: test://info/about, test://info/help
• Auto-discovery: Custom tools and resources from mate/ directory
• Configuration: Service container integration via .mate/services.php

Quick Start

git clone https://github.com/wachterjohannes/debug-mcp-symfony-example.git
cd debug-mcp-symfony-example
composer install

Setup

Claude Code (Recommended)

cd /path/to/debug-mcp-symfony-example
claude mcp add mate $(pwd)/vendor/bin/mate --scope local
claude mcp list  # Verify: mate - ✓ Connected

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mate": {
      "command": "/absolute/path/to/debug-mcp-symfony-example/vendor/bin/mate"
    }
  }
}

Restart Claude Desktop.

Testing the MCP Server

Tools

Test the available MCP tools:

• "What PHP version is running?" → php-version tool
• "What operating system are we on?" → operating-system tool
• "What PHP extensions are loaded?" → php-extensions tool
• "Run the test tool" → test_tool tool

Resources

Test the available resources:

• "Show me the test information" → test://info/about resource
• "Show me help for the MCP server" → test://info/help resource

Use Cases

• Check PHP version and environment info during development
• List loaded PHP extensions without leaving your editor
• Verify system configuration for debugging
• Extend with custom tools in the mate/ directory
• Configure services via .mate/services.php for DI container integration

Add Your Own Tools

Create mate/MyTool.php:

<?php
namespace App\Mate;

use Symfony\Component\AiMate\Attribute\Tool;

class MyTool {
    #[Tool(name: 'my_tool', description: 'Does something useful')]
    public function execute(string $input): array {
        return ['result' => "Processed: $input"];
    }
}

Tools in mate/ are auto-discovered on the next request.

Configuration

Service Configuration

Edit .mate/services.php to configure the MCP server and add custom services:

<?php
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $container): void {
    $container->parameters()
        ->set('mate.cache_dir', sys_get_temp_dir().'/mate')
        ->set('mate.env_file', ['.env'])
    ;

    $container->services()
        // Add your custom services here
    ;
};

Extension Management

Extensions are managed in .mate/extensions.php (auto-generated by mate discover):

return [
    'symfony/ai-mate' => ['enabled' => true],
];

Run mate discover to scan for and register new extensions.

Requirements

PHP 8.4+, Composer

License

MIT