PHPackages                             productowner-ro/symfony-profiler-mcp - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Debugging &amp; Profiling](/categories/debugging)
4. /
5. productowner-ro/symfony-profiler-mcp

ActiveSymfony-bundle[Debugging &amp; Profiling](/categories/debugging)

productowner-ro/symfony-profiler-mcp
====================================

Symfony bundle that exposes profiler data via MCP protocol to AI-powered IDEs. Built on symfony/mcp-bundle.

v0.1.0(3mo ago)45↓90%MITPHPPHP &gt;=8.2CI passing

Since Mar 26Pushed 3mo agoCompare

[ Source](https://github.com/productowner-ro/symfony-profiler-mcp)[ Packagist](https://packagist.org/packages/productowner-ro/symfony-profiler-mcp)[ RSS](/packages/productowner-ro-symfony-profiler-mcp/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (2)Dependencies (10)Versions (3)Used By (0)

Symfony Profiler MCP
====================

[](#symfony-profiler-mcp)

Symfony bundle that exposes profiler data to AI-powered IDEs via the [Model Context Protocol](https://modelcontextprotocol.io/). Built on [symfony/mcp-bundle](https://symfony.com/doc/current/ai/bundles/mcp-bundle.html).

**By [ProductOwner.ro](https://productowner.ro) in collaboration with Claude.**

> Inspired by [killerwolf/mcp-profiler-bundle](https://github.com/killerwolf/mcp-profiler-bundle). Rewritten from scratch to fix context bloat, broken tool names, and missing data redaction.

Requirements
------------

[](#requirements)

- PHP &gt;= 8.2
- Symfony &gt;= 7.3
- [symfony/mcp-bundle](https://github.com/symfony/mcp-bundle) &gt;= 0.6

Installation
------------

[](#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
------------

[](#how-it-works)

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

1. **Tools** return compact summaries with `resource_uri` pointers
2. **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

[](#mcp-tools)

ToolDescription`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

[](#mcp-resource-templates)

URI TemplateDescription`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

[](#key-differences-from-killerwolfmcp-profiler-bundle)

IssueOriginalThis BundleTool names`profiler:list` (breaks Claude Code)`symfony-profiler-list` (API-compliant)Context sizeDumps ALL collectors at once (megabytes)Two-tier: summaries first, detail on demandResponse formatMixed JSON + VarDumper textAlways clean JSONSecurityExposes cookies, auth headers, server varsAutomatic redaction of sensitive dataCode duplicationPath logic copy-pasted 4xSingle `ProfilerStorageResolver`MCP protocol220 lines hand-rolled JSON-RPCUses `symfony/mcp-bundle` (zero protocol code)PHP 8.4Deprecation warningsClean supportMulti-App 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
---------------------------

[](#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
-----------------

[](#ide-configuration)

### Claude Code

[](#claude-code)

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

### Cursor / Windsurf

[](#cursor--windsurf)

Add to your MCP configuration following the same pattern.

License
-------

[](#license)

MIT - See [LICENSE](LICENSE).

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance82

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

92d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3596b159c959ee9d7199e9e32b6e078b1a5406cf59a8beefc7abdb131343d4d4?d=identicon)[gabiudrescu](/maintainers/gabiudrescu)

---

Top Contributors

[![gabiudrescu](https://avatars.githubusercontent.com/u/5156054?v=4)](https://github.com/gabiudrescu "gabiudrescu (17 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/productowner-ro-symfony-profiler-mcp/health.svg)

```
[![Health](https://phpackages.com/badges/productowner-ro-symfony-profiler-mcp/health.svg)](https://phpackages.com/packages/productowner-ro-symfony-profiler-mcp)
```

###  Alternatives

[symfony/web-profiler-bundle

Provides a development tool that gives detailed information about the execution of any request

2.3k156.8M1.2k](/packages/symfony-web-profiler-bundle)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.5M376](/packages/easycorp-easyadmin-bundle)[symfony/framework-bundle

Provides a tight integration between Symfony components and the Symfony full-stack framework

3.6k246.0M11.1k](/packages/symfony-framework-bundle)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.4M519](/packages/shopware-core)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.1k16.8k](/packages/prestashop-prestashop)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
