MCP Profiler Bundle

https://github.com/killerwolf/mcp-profiler-bundle
Admin
MCP Profiler Bundle is a Symfony bundle that exposes Symfony Profiler data through the Model Context...
Tokens:29,290
Snippets:368
Trust Score:7.4
Update:2 months ago
Show doc for...
Tokens:
Raw
### Configure Bundle Settings

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/08-configuration-and-setup.md

Examples of minimal and full configuration settings for the bundle.

```yaml
killerwolf_mcp_profiler: ~
```

```yaml
killerwolf_mcp_profiler:
  name: "My Custom MCP Profiler"
  version: "2.0.0"
```

--------------------------------

### Composer Configuration

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/08-configuration-and-setup.md

Example composer.json structure for the bundle.

```json
{
  "name": "killerwolf/mcp-profiler-bundle",
  "description": "Allow access to symfony profiler data through MCP protocol",
  "type": "symfony-bundle",
  "license": "MIT",
  "require": {
    "php": ">=8.1",
    "symfony/framework-bundle": "^6.4|^7.0",
    "symfony/console": "^6.4|^7.0",
    "symfony/http-kernel": "^6.4|^7.0",
    "ext-pcntl": "*"
  },
  "autoload": {
    "psr-4": {
      "Killerwolf\\MCPProfilerBundle\\": ""
    }
  }
}
```

--------------------------------

### Show Action Output (With Collector)

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/03-commands-reference.md

Example output when a specific collector is requested.

```text
Profile for "abc123" (App Variant: app1)

Profile Information
════════════════════════════════════════════════════════════════
 ...

Collector: request
════════════════════════════════════════════════════════════════
Collector 'request' data (dumped):
RequestDataCollector {
  method: "GET"
  request_headers: {...}
  response_headers: {...}
  status_code: 200
}
```

--------------------------------

### List Action Output

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/03-commands-reference.md

Example output format for the list action.

```text
Listing the 20 most recent profiles

┌──────────────┬────────┬──────┬──────┬─────────────────┬──────────────────┬────────┐
│ APP_VARIANT  │ Token  │ IP   │ Meth │ URL             │ Time             │ Status │
├──────────────┼────────┼──────┼──────┼─────────────────┼──────────────────┼────────┤
│ app1         │ abc123 │ 127.0│ GET  │ /api/users      │ 2024-08-11 14:30 │ 200    │
│ -            │ def456 │ 127.0│ POST │ /api/users      │ 2024-08-11 14:29 │ 201    │
└──────────────┴────────┴──────┴──────┴─────────────────┴──────────────────┴────────┘
```

--------------------------------

### ProfilerGetAllCollectorByToken Response Examples

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/05-tool-implementations.md

Example JSON responses for successful retrieval and error states.

```json
["request", "exception", "doctrine", "config", "assets"]
```

```json
{
  "error": "No profile found for token: abc123. Checked: ... and ..."
}
```

--------------------------------

### Define Bundle Configuration Schema

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/08-configuration-and-setup.md

Example of the YAML configuration structure for the bundle.

```yaml
killerwolf_mcp_profiler:
  name: "Symfony MCP Profiler Bundle"    # Configurable bundle name
  version: "1.0.0"                        # Configurable version string
```

--------------------------------

### Troubleshooting Configuration Snippets

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/08-configuration-and-setup.md

Configuration and verification commands for troubleshooting common setup issues.

```bash
framework.profiler.collect: true
```

```bash
bin/console mcp:profiler list
```

```bash
bin/console debug:container | grep mcp
```

```bash
ls -la bin/console
```

```bash
bin/console cache:clear
```

--------------------------------

### Show Action Output (No Collector)

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/03-commands-reference.md

Example output when no specific collector is requested.

```text
Profile for "abc123" (App Variant: app1)

Profile Information
════════════════════════════════════════════════════════════════
 App Variant   app1
 Token         abc123
 IP            127.0.0.1
 Method        GET
 URL           http://example.com/api/users
 Time          2024-08-11 14:30:45
 Status        200

Available Collectors
┌───────────────┬────────────────────────────────────┐
│ Collector     │ Data                               │
├───────────────┼────────────────────────────────────┤
│ request       │ Use --collector=request to view    │
│ doctrine      │ Use --collector=doctrine to view   │
│ cache         │ Use --collector=cache to view      │
└───────────────┴────────────────────────────────────┘
```

--------------------------------

### Example Profile JSON

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/07-types-and-data-structures.md

A sample JSON object representing a serialized profile.

```json
{
  "token": "abc123def456",
  "ip": "192.168.1.1",
  "method": "GET",
  "url": "http://example.com/api/users",
  "time": 1723388445,
  "status_code": 200,
  "appId": "app1"
}
```

--------------------------------

### CLI Workflow Examples

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/03-commands-reference.md

Common command-line usage patterns for listing recent requests and inspecting specific collectors.

```bash
bin/console mcp:profiler list --limit=5
```

```bash
bin/console mcp:profiler show abc123 --collector=doctrine
```

```bash
bin/console mcp:profiler show abc123 --collector=request
```

```bash
bin/console mcp:profiler show abc123 --collector=exception
```

--------------------------------

### Collector Data Examples

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/02-mcp-tools-reference.md

Examples of JSON-serializable and non-serializable collector data outputs.

```json
{
  "queries": [
    "SELECT * FROM users WHERE id = ?",
    "SELECT * FROM posts WHERE user_id = ?"
  ],
  "queryCount": 2,
  "time": 12.5
}
```

```text
Collector 'cache' data (dumped):
CacheCollector {
  calls: 10
  hits: 7
  misses: 3
  ...
}
```

--------------------------------

### ToolResponse Example

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/07-types-and-data-structures.md

Example of a JSON-encoded result within the ToolResponse structure.

```json
{
  "content": [
    {
      "type": "text",
      "text": "[{\"token\":\"abc123\",\"ip\":\"127.0.0.1\",\"method\":\"GET\",...}]"
    }
  ]
}
```

--------------------------------

### MCP Server Execution

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Start the MCP server to allow clients to connect via stdio.

```bash
# Run server
bin/console mcp:server:run
```

--------------------------------

### ProfilerGetOneCollectorByToken Response Examples

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/05-tool-implementations.md

Example responses for successful JSON data, text dumps, and various error conditions.

```json
{
  "queries": ["SELECT * FROM users"],
  "time": 12.5
}
```

```text
Collector 'cache' data (dumped):
CacheCollector {
  hits: 100
  misses: 10
  calls: 110
}
```

```json
{
  "error": "No profile found for token: abc123. Checked: ..."
}
```

```json
{
  "error": "Collector 'nonexistent' not found for token: abc123 (App: app1)"
}
```

```json
{
  "error": "Could not retrieve or represent data for collector 'collector_name'."
}
```

--------------------------------

### Install MCP Profiler Bundle

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/README.md

Use Composer to add the bundle to your Symfony project.

```bash
composer require killerwolf/mcp-profiler-bundle:^0.1
```

--------------------------------

### Run MCP Server Command

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/03-commands-reference.md

Command to start the MCP JSON-RPC server.

```bash
bin/console mcp:server:run
```

--------------------------------

### Return format for profiler:list

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/02-mcp-tools-reference.md

Example JSON-encoded array of profile objects returned by the tool.

```json
[
  {
    "token": "abc123def456",
    "ip": "192.168.1.1",
    "method": "GET",
    "url": "http://example.com/api/users",
    "time": "2024-08-11 14:30:45",
    "status_code": 200,
    "appId": "app1"
  }
]
```

--------------------------------

### Return Type Example for profiler:get_collectors

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/02-mcp-tools-reference.md

Example of the JSON-encoded string array returned by the tool.

```json
["request", "exception", "doctrine", "config", "assets"]
```

--------------------------------

### Directory Pattern

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/07-types-and-data-structures.md

Visual representation of the cache directory structure for single and multi-app setups.

```text
var/cache/
├── dev/profiler/        # Single app or default
└── app_id_variant/      # Multi-app structure
    └── dev/profiler/
```

--------------------------------

### ProfilerGetByTokenTool Return Format

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/02-mcp-tools-reference.md

Example of the JSON-encoded string returned by the tool containing profile metadata and collector data.

```json
{
  "token": "abc123def456",
  "ip": "192.168.1.1",
  "method": "GET",
  "url": "http://example.com/api/users",
  "time": 1723388445,
  "status_code": 200,
  "appId": "app1",
  "collectors": {
    "request": {
      "method": "GET",
      "request_headers": { "User-Agent": "...", "Accept": "application/json" },
      "response_headers": { "Content-Type": "application/json" },
      "request_server": { "HTTP_HOST": "example.com" },
      "request_cookies": { "session_id": "..." },
      "request_attributes": {},
      "request_query": { "page": "1" },
      "request_request": {},
      "content_type": "application/json",
      "status_code": 200,
      "status_text": "OK"
    },
    "doctrine": {
      "queries": ["SELECT ..."],
      "queryCount": 5
    }
  }
}
```

--------------------------------

### JSON-RPC Protocol Request and Response

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/03-commands-reference.md

Example of a tool call request and its corresponding response structure.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "profiler:list",
    "arguments": { "limit": 20 }
  }
}
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": { ... }
}
```

--------------------------------

### Get Container Extension

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Retrieves the bundle's DependencyInjection extension instance.

```php
public function getContainerExtension(): ?ExtensionInterface
```

```php
$extension = $bundle->getContainerExtension();
// Returns: Killerwolf\MCPProfilerBundle\DependencyInjection\MCPProfilerExtension
```

--------------------------------

### Constructor Injection Patterns

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Examples of constructor injection for various classes within the bundle, utilizing Symfony's dependency injection container.

```php
public function __construct(
    string $cacheDir,                    // %kernel.cache_dir%
    string $environment,                 // %kernel.environment%
    ParameterBagInterface $parameterBag  // @parameter_bag
)
```

```php
public function __construct(
    string $cacheDir  // %kernel.cache_dir%
)
```

```php
public function __construct(
    string $name = 'MCP Profiler',    // %mcp_profiler.name%
    string $version = '1.0.0'          // %mcp_profiler.version%
)
```

```php
// ProfilerList, ProfilerGetByTokenTool
public function __construct(
    string $baseCacheDir,           // Environment-specific cache dir
    string $environment,             // Environment name
    ?ParameterBagInterface $parameterBag = null
)

// ProfilerGetAllCollectorByToken, ProfilerGetOneCollectorByToken
public function __construct(
    string $baseCacheDir,   // Environment-specific cache dir
    string $environment     // Environment name
)
```

--------------------------------

### Get Full Profile Data

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/00-table-of-contents.md

Displays detailed data for a specific profile identified by its token.

```bash
bin/console mcp:profiler show <token>
```

--------------------------------

### initialize

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/06-json-rpc-protocol.md

Establishes the protocol connection and retrieves server capabilities. This must be the first method called.

```APIDOC
## initialize

### Description
Establishes protocol connection and retrieves server capabilities. This method must be called first; other methods return errors if not initialized.

### Request
```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": {
      "name": "<ide-name>",
      "version": "<ide-version>"
    }
  }
}
```

### Response
```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "tools": {
        "listChanged": true
      }
    },
    "serverInfo": {
      "name": "Symfony MCP Profiler Bundle (Static)",
      "version": "1.0.0"
    }
  }
}
```
```

--------------------------------

### ProfilerGetByTokenTool Constructor

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/05-tool-implementations.md

Initializes the tool with cache directory, environment, and optional parameter bag.

```php
public function __construct(
    string $baseCacheDir,
    string $environment,
    ?ParameterBagInterface $parameterBag = null
)
```

--------------------------------

### Initialize Protocol Connection

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/06-json-rpc-protocol.md

Establishes the connection and retrieves server capabilities. This must be the first method called.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": {
      "name": "<ide-name>",
      "version": "<ide-version>"
    }
  }
}
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "tools": {
        "listChanged": true
      }
    },
    "serverInfo": {
      "name": "Symfony MCP Profiler Bundle (Static)",
      "version": "1.0.0"
    }
  }
}
```

--------------------------------

### Show Action Syntax

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/03-commands-reference.md

Syntax for displaying detailed information for a specific profile token.

```bash
bin/console mcp:profiler show <token> [--collector=<name>] [-c <name>]
```

--------------------------------

### Initialize Connection

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/06-json-rpc-protocol.md

Establishes the protocol version and capabilities between the client and server.

```json
CLIENT → SERVER
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": {"name": "claude", "version": "1.0"}
  }
}

SERVER → CLIENT
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {"tools": {"listChanged": true}},
    "serverInfo": {"name": "Symfony MCP Profiler Bundle (Static)", "version": "1.0.0"}
  }
}
```

--------------------------------

### Error Response for profiler:get_collectors

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/02-mcp-tools-reference.md

Example error response when a profile is not found.

```json
{
  "error": "No profile found for token: abc123. Checked: ... and ..."
}
```

--------------------------------

### ProfilerGetAllCollectorByToken Constructor

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/05-tool-implementations.md

Initializes the tool with the base cache directory and environment name.

```php
public function __construct(string $baseCacheDir, string $environment)
```

--------------------------------

### Command Constructor Dependencies

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/03-commands-reference.md

Required services and parameters for the RunMCPServerCommand constructor.

```php
public function __construct(
    string $cacheDir,
    string $environment,
    ParameterBagInterface $parameterBag
)
```

--------------------------------

### Get Extension Alias

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Returns the extension alias used for the configuration namespace.

```php
public function getAlias(): string
```

```yaml
# config/packages/mcp_profiler.yaml
killerwolf_mcp_profiler:
  name: "My Custom Name"
  version: "2.0.0"
```

--------------------------------

### Line-delimited JSON protocol

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/06-json-rpc-protocol.md

Example of requests and responses transmitted as single-line JSON objects.

```json
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{...}}\n
{"jsonrpc":"2.0","id":1,"result":{...}}\n
{"jsonrpc":"2.0","id":2,"method":"tools/list"}\n
{"jsonrpc":"2.0","id":2,"result":{"tools":[...]}}\n
```

--------------------------------

### Get Collector Name

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Returns the identifier used by the Symfony Web Profiler toolbar.

```php
public function getName(): string
```

--------------------------------

### Direct Tool Instantiation for Profiler List

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/09-api-usage-examples.md

Instantiates the ProfilerList tool to fetch and iterate over recent profiles. Requires a valid cache directory path, environment string, and parameter bag.

```php
// Not typically used externally; shown for understanding

use Killerwolf\MCPProfilerBundle\Tools\ProfilerList;

$tool = new ProfilerList(
    '/var/www/project/var/cache/dev',
    'dev',
    $parameterBag
);

$json = $tool->execute(limit: 20);
$profiles = json_decode($json, true);

foreach ($profiles as $profile) {
    echo sprintf(
        "%s %s %s %d\n",
        $profile['token'],
        $profile['method'],
        $profile['url'],
        $profile['status_code']
    );
}
```

--------------------------------

### Show Full Profile via CLI

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/09-api-usage-examples.md

Display detailed information for a specific profile token.

```bash
bin/console mcp:profiler show a1b2c3d4e5f6
```

--------------------------------

### Implement Configuration Tree

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/08-configuration-and-setup.md

PHP implementation of the configuration tree using TreeBuilder in the DependencyInjection folder.

```php
$treeBuilder = new TreeBuilder('killerwolf_mcp_profiler');
$rootNode = $treeBuilder->getRootNode();

$rootNode
    ->addDefaultsIfNotSet()
    ->children()
        ->scalarNode('name')->defaultValue('Symfony MCP Profiler Bundle')->end()
        ->scalarNode('version')->defaultValue('1.0.0')->end()
    ->end()
;
```

--------------------------------

### Build Configuration Tree

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Defines the configuration schema tree for the bundle.

```php
public function getConfigTreeBuilder(): TreeBuilder
```

```yaml
killerwolf_mcp_profiler:
  name: "Custom MCP Profiler"
  version: "1.5.0"
```

--------------------------------

### List Action Syntax

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/03-commands-reference.md

Syntax for listing recent profiler tokens.

```bash
bin/console mcp:profiler list [--limit=20] [-l 20]
```

--------------------------------

### ProfilerGetByTokenTool Error Response

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/02-mcp-tools-reference.md

Example of the JSON error response returned when a profile cannot be located for the provided token.

```json
{
  "error": "No profile found for token: abc123. Checked: /path/to/var/cache/dev/profiler; ..."
}
```

--------------------------------

### Update Tool Class Instantiation

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/docs/mcp_server_multi_app_plan.md

Instantiate tool classes with base cache directory and environment parameters.

```php
'profiler:list' => (new ProfilerList($baseCacheDir, $envName, $this->parameterBag))->execute(...)
'profiler:get_collectors' => (new ProfilerGetAllCollectorByToken($baseCacheDir, $envName))->execute(...)
'profiler:get_collector' => (new ProfilerGetOneCollectorByToken($baseCacheDir, $envName))->execute(...)
'profiler:get_by_token' => (new ProfilerGetByTokenTool($baseCacheDir, $envName, $this->parameterBag))->execute(...)
```

--------------------------------

### Define DoctrineCollector interface and example

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/07-types-and-data-structures.md

Defines the structure for database query tracking, followed by a sample JSON payload.

```typescript
interface DoctrineCollector {
  queries: string[];           // Array of SQL queries
  queryCount: number;          // Number of queries executed
  connectionName?: string;     // Database connection name
  time?: number;               // Total execution time (ms)
}
```

```json
{
  "queries": [
    "SELECT * FROM users WHERE id = ?",
    "SELECT * FROM posts WHERE user_id = ? LIMIT 10"
  ],
  "queryCount": 2,
  "time": 12.5
}
```

--------------------------------

### List and Show Profiles via CLI

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/08-configuration-and-setup.md

Commands to list recent profiles or display details for a specific profile token.

```bash
bin/console mcp:profiler list --limit=20
bin/console mcp:profiler list -l 5
```

```bash
bin/console mcp:profiler show abc123def456
```

--------------------------------

### ProfilerGetByTokenTool execute Method Signature

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/05-tool-implementations.md

Defines the entry point for retrieving profile data using a specific token.

```php
public function execute(string $token): string
```

--------------------------------

### Checked Paths in Error Messages

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/07-types-and-data-structures.md

Examples of error message strings generated when a profile is not found, varying by search scope.

```text
"Checked: /path/to/cache/dev/profiler (not found)"
```

```text
"Checked: /path/to/cache/dev/profiler (not found); /path/to/cache/*_*/dev/profiler (no app dirs found)"
```

```text
"Checked: /path/to/cache/dev/profiler; /path/to/cache/app1_var1/dev/profiler; /path/to/cache/app2_var2/dev/profiler"
```

--------------------------------

### Implement Multi-App Profiler Directory Discovery

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/docs/mcp_server_multi_app_plan.md

Use Symfony Finder to locate application-specific profiler directories and initialize temporary storage instances.

```php
$finder = new Finder();
$finder->directories()->in($this->baseCacheDir)->name('*_*');
foreach ($finder as $appIdDir) {
	$profilerDir = $appIdDir->getRealPath() . '/' . $this->environment . '/profiler';
	if (is_dir($profilerDir)) {
		$storage = new FileProfilerStorage('file:' . $profilerDir);
		$tempProfiler = new Profiler($storage);
		$appId = $appIdDir->getFilename();
	}
}
```

--------------------------------

### Define RequestCollector interface and example

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/07-types-and-data-structures.md

Defines the structure for HTTP request and response data, followed by a sample JSON payload.

```typescript
interface RequestCollector {
  method: string;                  // HTTP method
  request_headers: Object;         // Request header dict
  response_headers: Object;        // Response header dict
  request_server: Object;          // $_SERVER superglobal
  request_cookies: Object;         // $_COOKIE superglobal
  request_attributes: Object;      // Request attributes
  request_query: Object;           // $_GET superglobal
  request_request: Object;         // $_POST superglobal
  content_type: string;            // Response Content-Type
  status_code: number;             // HTTP status code
  status_text: string;             // Status text (OK, Created, etc.)
}
```

```json
{
  "method": "POST",
  "request_headers": {
    "Content-Type": "application/json",
    "User-Agent": "curl/7.68.0",
    "Accept": "application/json"
  },
  "response_headers": {
    "Content-Type": "application/json",
    "X-Powered-By": "Symfony"
  },
  "request_query": {"page": "1"},
  "request_request": {"name": "John"},
  "status_code": 201
}
```

--------------------------------

### Get Full Profile Data

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/09-api-usage-examples.md

Fetches comprehensive data for a specific request profile using the profiler:get_by_token tool.

```json
Request:
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "profiler:get_by_token",
    "arguments": {
      "token": "a1b2c3d4e5f6"
    }
  }
}

Response:
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{
      "type": "text",
      "text": "{
        \"token\": \"a1b2c3d4e5f6\",
        \"ip\": \"127.0.0.1\",
        \"method\": \"GET\",
        \"url\": \"http://localhost/api/users\",
        \"time\": 1723388445,
        \"status_code\": 200,
        \"collectors\": {
          \"request\": {
            \"method\": \"GET\",
            \"request_headers\": {
              \"User-Agent\": \"Mozilla/5.0\",
              \"Accept\": \"application/json\"
            },
            \"response_headers\": {
              \"Content-Type\": \"application/json\",
              \"X-Powered-By\": \"Symfony\"
            },
            \"status_code\": 200
          },
          \"doctrine\": {
            \"queries\": [
              \"SELECT u FROM User u WHERE u.active = 1\",
              \"SELECT COUNT(*) FROM User u\"
            ],
            \"queryCount\": 2,
            \"time\": 5.3
          },
          \"cache\": {
            \"calls\": 15,
            \"hits\": 12,
            \"misses\": 3
          }
        }
      }"
    }]
  }
}
```

--------------------------------

### List Available Tools

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/06-json-rpc-protocol.md

Retrieves the list of available profiler tools from the server.

```json
CLIENT → SERVER
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list"
}

SERVER → CLIENT
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "tools": [
      {"name": "profiler:list", ...},
      {"name": "profiler:get_collectors", ...},
      {"name": "profiler:get_collector", ...},
      {"name": "profiler:get_by_token", ...}
    ]
  }
}
```

--------------------------------

### Configure Bundle Parameters

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/08-configuration-and-setup.md

Set bundle parameters via configuration files or directly in container parameters.

```yaml
killerwolf_mcp_profiler:
  name: "Custom Name"
  version: "2.0.0"
```

```yaml
parameters:
  mcp_profiler.name: "Custom Name"
  mcp_profiler.version: "2.0.0"
```

--------------------------------

### Derive Cache Directory and Environment

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/docs/mcp_server_multi_app_plan.md

Calculate the base cache directory and environment name before tool execution.

```php
$baseCacheDir = dirname(dirname($this->cacheDir)); // e.g., /path/to/project/var/cache
$envName = $this->environment; // Use the injected environment name
```

--------------------------------

### Implement Extension Class

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/08-configuration-and-setup.md

The MCPProfilerExtension class handles loading service definitions from YAML files.

```php
namespace Killerwolf\MCPProfilerBundle\DependencyInjection;

class MCPProfilerExtension extends Extension
{
    public function load(array $configs, ContainerBuilder $container): void
    {
        $loader = new YamlFileLoader(
            $container,
            new FileLocator(__DIR__ . '/../Resources/config')
        );
        $loader->load('services.yaml');
        // ...
    }

    public function getAlias(): string
    {
        return 'killerwolf_mcp_profiler';
    }
}
```

--------------------------------

### List Available Tools

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/06-json-rpc-protocol.md

Retrieves the list of available profiler tools and their corresponding input schemas.

```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list"
}
```

```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "tools": [
      {
        "name": "profiler:list",
        "description": "Lists available profiler tokens.",
        "inputSchema": {
          "type": "object",
          "$schema": "http://json-schema.org/draft-07/schema#",
          "properties": {
            "limit": {
              "type": "integer",
              "default": 10
            }
          }
        }
      },
      {
        "name": "profiler:get_collectors",
        "description": "Gets all collector data for a specific profiler token.",
        "inputSchema": {
          "type": "object",
          "$schema": "http://json-schema.org/draft-07/schema#",
          "properties": {
            "token": {
              "type": "string"
            }
          },
          "required": ["token"]
        }
      },
      {
        "name": "profiler:get_collector",
        "description": "Gets specific collector data for a specific profiler token.",
        "inputSchema": {
          "type": "object",
          "$schema": "http://json-schema.org/draft-07/schema#",
          "properties": {
            "token": {
              "type": "string"
            },
            "collector": {
              "type": "string"
            }
          },
          "required": ["token", "collector"]
        }
      },
      {
        "name": "profiler:get_by_token",
        "description": "Gets basic profile data for a specific token.",
        "inputSchema": {
          "type": "object",
          "$schema": "http://json-schema.org/draft-07/schema#",
          "properties": {
            "token": {
              "type": "string"
            }
          },
          "required": ["token"]
        }
      }
    ]
  }
}
```

--------------------------------

### Register the Bundle

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/01-bundle-overview.md

Add the bundle to the application's configuration file, typically restricted to the dev environment.

```php
// config/bundles.php
return [
    Killerwolf\MCPProfilerBundle\MCPProfilerBundle::class => ['dev' => true],
];
```

--------------------------------

### View Documentation Directory Structure

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/MANIFEST.md

Displays the file hierarchy of the documentation project.

```text
/workspace/home/output/
├── README.md                                    (Entry point)
├── MANIFEST.md                                  (This file)
├── 00-table-of-contents.md                      (Index)
├── 01-bundle-overview.md
├── 02-mcp-tools-reference.md
├── 03-commands-reference.md
├── 04-classes-and-services.md
├── 05-tool-implementations.md
├── 06-json-rpc-protocol.md
├── 07-types-and-data-structures.md
├── 08-configuration-and-setup.md
├── 09-api-usage-examples.md
└── 10-architecture-and-internals.md
```

--------------------------------

### View Multi-App Cache Structure

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/08-configuration-and-setup.md

Directory layout for multi-app deployments where the bundle searches multiple paths.

```text
var/cache/
├── app_id_variant1/
│   └── dev/
│       └── profiler/
├── app_id_variant2/
│   └── dev/
│       └── profiler/
└── dev/
    └── profiler/  (default/fallback)
```

--------------------------------

### ProfilerList Constructor

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/05-tool-implementations.md

Initializes the ProfilerList tool with environment-specific cache paths and optional Symfony parameter bag.

```php
public function __construct(
    string $injectedCacheDir,
    string $environment,
    ?ParameterBagInterface $parameterBag = null
)
```

--------------------------------

### Show Profile Details via CLI

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/09-api-usage-examples.md

Retrieves detailed information for a specific profile token, optionally filtering by a specific collector.

```bash
bin/console mcp:profiler show <slow_token>
```

```bash
bin/console mcp:profiler show <slow_token> --collector=doctrine
```

```bash
bin/console mcp:profiler show <slow_token> --collector=request
```

```bash
bin/console mcp:profiler show <error_token>
```

```bash
bin/console mcp:profiler show <error_token> --collector=exception
```

```bash
bin/console mcp:profiler show <error_token> --collector=request
```

```bash
bin/console mcp:profiler show <token> # Automatically finds correct app
```

```bash
bin/console mcp:profiler show <token> --collector=config
```

--------------------------------

### Programmatic Tool Execution

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Instantiate and execute the ProfilerList tool to retrieve profile data as an array.

```php
use Killerwolf\MCPProfilerBundle\Tools\ProfilerList;

$tool = new ProfilerList(
    '/path/to/var/cache/dev',
    'dev',
    $parameterBag
);

$json = $tool->execute(limit: 20);
$profiles = json_decode($json, true);
```

--------------------------------

### Define a Custom Tool Class

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/10-architecture-and-internals.md

Implement a new tool by creating a class with an execute method.

```php
class CustomTool {
    public function execute(...): string { ... }
}
```

--------------------------------

### Multi-App Detection Logic

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/05-tool-implementations.md

Outlines the steps for extracting app variant IDs from directory paths.

```text
1. Split path by '/'
2. Find first directory segment containing '_'
3. Extract app ID as first part before '_' (via explode('_', name)[0])
4. Include appId in response if found
```

--------------------------------

### Debug Commands

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/08-configuration-and-setup.md

Utility commands to inspect services, configuration, and clear cache.

```bash
bin/console debug:container mcp
bin/console debug:container profiler
```

```bash
bin/console debug:config killerwolf_mcp_profiler
```

```bash
bin/console list | grep mcp
```

```bash
bin/console cache:clear
rm -rf var/cache/dev/profiler/*
```

--------------------------------

### CLI Usage Commands

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/01-bundle-overview.md

Commands for running the MCP server or inspecting profiler data directly from the terminal.

```bash
# Run MCP server (for IDE integration)
bin/console mcp:server:run

# Debug profiler via CLI
bin/console mcp:profiler list --limit=20
bin/console mcp:profiler show <token>
bin/console mcp:profiler show <token> --collector=request
```

--------------------------------

### Profiler Command Constructor

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/03-commands-reference.md

Constructor for the ProfilerCommand class requiring the cache directory path.

```php
public function __construct(string $cacheDir)
```

--------------------------------

### Default Autowiring and Autoconfiguration

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Standard service configuration settings for autowiring, autoconfiguration, and service visibility.

```yaml
_defaults:
  autowire: true
  autoconfigure: true
  public: false
```

--------------------------------

### Register RunMCPServerCommand

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Defines the RunMCPServerCommand service with public scope and console command tagging.

```yaml
Killerwolf\MCPProfilerBundle\Command\RunMCPServerCommand:
  arguments:
    - '%kernel.cache_dir%'
    - '%kernel.environment%'
    - '@parameter_bag'
  tags:
    - { name: 'console.command' }
  public: true
```

--------------------------------

### Derive Path Resolution Algorithm

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/10-architecture-and-internals.md

Logic for determining direct and multi-app paths based on the cache directory and environment.

```text
Input:
  cacheDir = "/project/var/cache/dev"
  environment = "dev"

Step 1: Derive direct path
  directPath = cacheDir + "/profiler"
  → "/project/var/cache/dev/profiler"

Step 2: Get parent of cacheDir
  parentOfCacheDir = dirname(cacheDir)
  → "/project/var/cache"

Step 3: Check if parent contains underscore
  if (strpos(basename(parentOfCacheDir), '_') !== false)
    multiAppBaseSearchDir = dirname(parentOfCacheDir)
  else
    multiAppBaseSearchDir = parentOfCacheDir

  In this case:
  basename("/project/var/cache") = "cache" (no underscore)
  multiAppBaseSearchDir = "/project/var/cache"

Step 4: Multi-app pattern
  multiAppPathPattern = multiAppBaseSearchDir + "/*_*/" + environment + "/profiler"
  → "/project/var/cache/*_*/dev/profiler"

Result:
  • Direct: /project/var/cache/dev/profiler
  • Multi: /project/var/cache/*_*/dev/profiler
```

```text
Input:
  cacheDir = "/project/var/cache/app_id_var1/dev"
  environment = "dev"

Step 1: Direct path
  → "/project/var/cache/app_id_var1/dev/profiler"

Step 2-3: Parent analysis
  parentOfCacheDir = "/project/var/cache/app_id_var1"
  basename = "app_id_var1" (contains underscore!)
  multiAppBaseSearchDir = dirname(parentOfCacheDir)
  → "/project/var/cache"

Step 4: Multi-app pattern
  → "/project/var/cache/*_*/dev/profiler"

Result: Same multi-app pattern, different direct path
```

--------------------------------

### tools/list

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/06-json-rpc-protocol.md

Retrieves a list of available tools with their respective input schemas.

```APIDOC
## tools/list

### Description
Retrieves list of available tools with input schemas.

### Request
```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list"
}
```

### Response
```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "tools": [
      {
        "name": "profiler:list",
        "description": "Lists available profiler tokens.",
        "inputSchema": {
          "type": "object",
          "$schema": "http://json-schema.org/draft-07/schema#",
          "properties": {
            "limit": {
              "type": "integer",
              "default": 10
            }
          }
        }
      }
    ]
  }
}
```
```

--------------------------------

### CLI Command Execution

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Use Symfony console commands to list or display specific profiles.

```bash
# List profiles
bin/console mcp:profiler list --limit=10

# Show profile
bin/console mcp:profiler show abc123def456
```

--------------------------------

### ProfilerGetByTokenTool Request Schema

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/02-mcp-tools-reference.md

JSON schema defining the required input parameters for the tool.

```json
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": ["token"]
}
```

--------------------------------

### Build Bundle Container

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Defines the build method for the bundle container configuration.

```php
public function build(ContainerBuilder $container): void
```

```php
// Automatically called by Symfony; not invoked manually
$bundle = new MCPProfilerBundle();
$bundle->build($container);
```

--------------------------------

### Initialize MCPDataCollector

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Constructor for the data collector with optional name and version parameters.

```php
public function __construct(string $name = 'MCP Profiler', string $version = '1.0.0')
```

--------------------------------

### Path Resolution Algorithm

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/05-tool-implementations.md

Defines the sequence for locating profiler storage paths, prioritizing direct paths before falling back to multi-app patterns.

```text
1. Calculate direct profiler path:
   directPath = cacheDir + '/profiler'

2. Calculate multi-app base directory:
   parentOfCacheDir = dirname(cacheDir)
   if parentOfCacheDir contains '_':
       multiAppBaseDir = dirname(parentOfCacheDir)
   else:
       multiAppBaseDir = parentOfCacheDir

3. Search direct path first
4. Search multi-app pattern: multiAppBaseDir/*_*/env/profiler
```

--------------------------------

### Locate Profile by Token Across Applications

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/docs/mcp_server_multi_app_plan.md

Iterate through storage instances to find a specific token and load the corresponding profile.

```php
$profile = null; $foundAppId = null;
foreach ($finder as $appIdDir) {
	// ... (storage initialization)
	if ($storage->read($token)) {
		$tempProfiler = new Profiler($storage);
		$profile = $tempProfiler->loadProfile($token);
		$foundAppId = $appIdDir->getFilename();
		break;
	}
}
```

--------------------------------

### List Profiles via CLI

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/09-api-usage-examples.md

Retrieve a list of recent profiles using the Symfony console command.

```bash
bin/console mcp:profiler list --limit=5
```

--------------------------------

### Notify Initialization Complete

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/06-json-rpc-protocol.md

Signals that the initialization handshake is finished.

```json
CLIENT → SERVER
{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}

SERVER → (no response)
```

--------------------------------

### Tool Parameter Type Coercion

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/07-types-and-data-structures.md

Demonstrates how tool arguments are coerced or defaulted based on their expected types.

```php
// String parameters
$arguments['token'] ?? ''           // Empty string if missing
$arguments['collector'] ?? ''       // Empty string if missing

// Integer parameters
$arguments['limit'] ?? 10           // Default 10 if missing
$arguments['statusCode'] ?? null    // Optional filter
(int) $input->getOption('limit')   // CLI coercion
```

--------------------------------

### Performance Characteristics

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/10-architecture-and-internals.md

Latency benchmarks for core profiler operations and scaling factors.

```text
Operation | Time | Factors
─────────────────────────────────────────────────
profiler:list      | 50-200ms | Disk I/O, # of profiles
get_collectors     | 10-50ms  | Profile size, # collectors
get_by_token       | 100-500ms| Collector serialization
get_collector      | 50-200ms | Individual collector size

Multi-app search adds 2-5x to search operations (# of app dirs)
```

--------------------------------

### Complex Filtering via CLI and MCP

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/09-api-usage-examples.md

Demonstrates filtering profile lists by limit, method, and status code using both CLI and JSON-RPC.

```bash
bin/console mcp:profiler list --limit=20 -l 20
```

```json
{
  "method": "tools/call",
  "params": {
    "name": "profiler:list",
    "arguments": {
      "limit": 20,
      "method": "GET",
      "statusCode": 200
    }
  }
}
```

--------------------------------

### Dependency Chain Visualization

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/10-architecture-and-internals.md

Visual representation of service dependencies and component relationships.

```text
RunMCPServerCommand
  ├─ Depends on: %kernel.cache_dir%, %kernel.environment%, @parameter_bag
  └─ Creates: ProfilerList, ProfilerGetByTokenTool, ProfilerGetAllCollectorByToken, ProfilerGetOneCollectorByToken

ProfilerList
  ├─ Depends on: FileProfilerStorage, Profiler, Finder
  └─ Returns: JSON array of profiles

ProfilerGetByTokenTool
  ├─ Depends on: FileProfilerStorage, Profiler, VarCloner, CliDumper
  └─ Returns: JSON profile with collectors

ProfilerGetAllCollectorByToken
  ├─ Depends on: FileProfilerStorage, Profiler
  └─ Returns: JSON array of collector names

ProfilerGetOneCollectorByToken
  ├─ Depends on: FileProfilerStorage, Profiler, VarCloner, CliDumper
  └─ Returns: JSON or text dump of collector

MCPDataCollector
  ├─ Extends: DataCollector, LateDataCollectorInterface
  └─ Uses: Bundle name and version parameters

MCPProfilerBundle
  ├─ Extends: Bundle
  └─ Creates: MCPProfilerExtension

MCPProfilerExtension
  ├─ Loads: services.yaml, twig.yaml
  └─ Sets: parameters, processes configuration
```

--------------------------------

### Register Custom Tool in services.yaml

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/10-architecture-and-internals.md

Register the tool class as a service and apply the mcp.tool tag for discovery.

```yaml
Namespace\CustomTool:
  arguments: [...]
  tags:
    - { name: 'mcp.tool' }
```

--------------------------------

### Run MCP Inspector

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/README.md

Use the official MCP inspector tool to test and interact with your MCP server.

```bash
npx --registry https://registry.npmjs.org @modelcontextprotocol/inspector
```

--------------------------------

### Initialize notification request

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/06-json-rpc-protocol.md

Lifecycle notification sent from client to server after initialization is complete.

```json
{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}
```

--------------------------------

### Configure MCP Server in IDE

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/README.md

Add the MCP server configuration to your IDE settings to enable communication with the Symfony console command.

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

--------------------------------

### Profiler Command Usage

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/03-commands-reference.md

Common CLI usage patterns for listing profiles and viewing specific details.

```bash
# List recent profiles
bin/console mcp:profiler list --limit=20

# Show profile details
bin/console mcp:profiler show <token>

# Show specific collector
bin/console mcp:profiler show <token> --collector=request
```

--------------------------------

### tools/call

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/06-json-rpc-protocol.md

Executes a specific profiler tool by name with provided arguments.

```APIDOC
## JSON-RPC tools/call

### Description
Invokes a registered profiler tool to perform operations such as listing profiles or retrieving specific collector data.

### Method
JSON-RPC Request

### Parameters
- **name** (string) - Required - The name of the tool to execute (e.g., "profiler:list", "profiler:get_by_token").
- **arguments** (object) - Required - The arguments required by the specific tool.

### Request Example
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "profiler:list",
    "arguments": {"limit": 5}
  }
}

### Response
#### Success Response
- **content** (array) - A list of content objects containing the tool execution result.

#### Response Example
{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[{\"token\":\"abc123\",\"ip\":\"127.0.0.1\",...}]"
      }
    ]
  }
}
```

--------------------------------

### Run and Debug MCP Server

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/08-configuration-and-setup.md

Commands to execute the MCP server directly or pipe output to a log file for debugging.

```bash
bin/console mcp:server:run
```

```bash
# Capture server output for debugging
bin/console mcp:server:run > mcp_debug.log 2>&1 &

# Send test requests manually
echo '{"jsonrpc":"2.0","id":1,"method":"initialize"}' | bin/console mcp:server:run
```

--------------------------------

### Inspect Doctrine Collector via CLI

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/09-api-usage-examples.md

View database query information for a profile using the doctrine collector.

```bash
bin/console mcp:profiler show a1b2c3d4e5f6 --collector=doctrine
```

--------------------------------

### Retrieve Bundle Version

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Returns the bundle version from collected data.

```php
public function getBundleVersion(): string
```

--------------------------------

### Load Service Configuration

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/04-classes-and-services.md

Loads service configuration from YAML files during container compilation.

```php
public function load(array $configs, ContainerBuilder $container): void
```

```php
// Automatically called by Symfony
$extension = new MCPProfilerExtension();
$extension->load([], $container);
```

--------------------------------

### Error response for profiler:list

Source: https://github.com/killerwolf/mcp-profiler-bundle/blob/main/_autodocs/02-mcp-tools-reference.md

JSON response returned when no profiles match the provided criteria.

```json
{
  "message": "No profiles found matching the criteria. Checked: ..."
}
```
Tokens:
Raw