Symfony Profiler MCP

Symfony bundle that exposes profiler data to AI-powered IDEs via the Model Context Protocol. Built on symfony/mcp-bundle.

By ProductOwner.ro in collaboration with Claude.

Inspired by killerwolf/mcp-profiler-bundle. Rewritten from scratch to fix context bloat, broken tool names, and missing data redaction.

Requirements

PHP >= 8.2
Symfony >= 7.3
symfony/mcp-bundle >= 0.6

Installation

composer require --dev productowner-ro/symfony-profiler-mcp

The Symfony Flex recipe configures symfony/mcp-bundle transports and routes automatically. If your project doesn't use Flex, create the following files manually:

Manual configuration (without Flex)

config/packages/mcp.yaml

when@dev:
    mcp:
        client_transports:
            stdio: true   # For Claude Code, JetBrains, etc.
            http: true    # For /_mcp HTTP endpoint

config/routes/mcp.yaml (only needed if using HTTP transport)

when@dev:
    mcp:
        resource: .
        type: mcp

Then clear the cache and verify:

php bin/console cache:clear
php bin/console mcp:server   # Should start without errors (Ctrl+C to stop)

How It Works

This bundle uses a two-tier data model to keep context size minimal:

Tools return compact summaries with resource_uri pointers
Resources provide full detail only when explicitly requested

AI Agent calls tool              AI Agent reads resource (only if needed)
        |                                      |
  "list profiles"                   "give me the request
   "get profile X"                   collector for token X"
        |                                      |
        v                                      v
  Compact summary             symfony-profiler://profile/{token}/{collector}
  + resource_uri                               |
                                               v
                                 Formatted, redacted collector data

MCP Tools

| Tool | Description | |------|-------------| | symfony-profiler-list | List recent profiles with filters (method, status, url, ip, limit) | | symfony-profiler-get | Get profile summary with available collector URIs |

MCP Resource Templates

| URI Template | Description | |--------------|-------------| | symfony-profiler://profile/{token} | Profile overview with list of collectors | | symfony-profiler://profile/{token}/{collector} | Formatted collector data |

Key Differences from killerwolf/mcp-profiler-bundle

| Issue | Original | This Bundle | |-------|----------|-------------| | Tool names | profiler:list (breaks Claude Code) | symfony-profiler-list (API-compliant) | | Context size | Dumps ALL collectors at once (megabytes) | Two-tier: summaries first, detail on demand | | Response format | Mixed JSON + VarDumper text | Always clean JSON | | Security | Exposes cookies, auth headers, server vars | Automatic redaction of sensitive data | | Code duplication | Path logic copy-pasted 4x | Single ProfilerStorageResolver | | MCP protocol | 220 lines hand-rolled JSON-RPC | Uses symfony/mcp-bundle (zero protocol code) | | PHP 8.4 | Deprecation warnings | Clean support |

Multi-App Support

The bundle auto-discovers profiler directories in multi-app Symfony setups (e.g., var/cache/app1_hash/dev/profiler). No configuration needed.

Custom Collector Formatters

Implement CollectorFormatterInterface and tag your service:

use ProductOwner\SymfonyProfilerMcp\Profiler\Formatter\CollectorFormatterInterface;
use Symfony\Component\HttpKernel\DataCollector\DataCollectorInterface;

class MyCollectorFormatter implements CollectorFormatterInterface
{
    public function getName(): string
    {
        return 'my_collector';
    }

    public function format(DataCollectorInterface $collector): array
    {
        return ['key' => 'formatted data'];
    }

    public function getSummary(DataCollectorInterface $collector): array
    {
        return ['key' => 'compact summary'];
    }
}

The CollectorFormatterInterface is auto-tagged. Just register your class as a service.

IDE Configuration

Claude Code

{
  "mcpServers": {
    "symfony-profiler": {
      "command": "php",
      "args": ["bin/console", "mcp:server"],
      "cwd": "/path/to/your/symfony/project"
    }
  }
}

Cursor / Windsurf

Add to your MCP configuration following the same pattern.

License

MIT - See LICENSE.

MCP Servers