mcp-profiler-bundle

This MCP server bundle exposes Symfony Profiler data through the MCP protocol, allowing your AI-powered IDEs and tools to query profiler entries, fetch detailed profile data, and inspect collectors via a standardized JSON-RPC interface. After installing the bundle in a Symfony project and running the MCP server command, you can use the MCP Inspector in supported IDEs to connect to the server and browse data such as recent profiler entries, specific profiler entries by token, and the collectors associated with those entries. The built-in tools map to profiler actions like listing profiles, retrieving a profile by token, and fetching collectors for a profile, enabling interactive exploration directly from your editor or assistant.

To get started, configure the MCP server in your IDE using the provided mcp:server:run command from your Symfony project. Then, use the MCP Inspector (via npm-based inspector package or your IDE's MCP integration) to connect and begin issuing commands such as profiler_list, profiler_get_by_token, profiler_get_all_collector_by_token, and profiler_get_one_collector_by_token. These tools mirror the Symfony Profiler capabilities and expose data in a format suitable for IDE-assisted debugging and code understanding.

Prerequisites:

• PHP (7.4+ recommended) and Composer
• A Symfony project where you can install bundles

Installation steps:

1. Install the bundle via Composer: composer require killerwolf/mcp-profiler-bundle:^0.1

2. Enable the bundle in your Symfony application by adding it to config/bundles.php: return [ // ... Killerwolf\MCPProfilerBundle\MCPProfilerBundle::class => ['dev' => true], ];

3. Run the MCP server within your Symfony project (this will start listening for MCP requests): php bin/console mcp:server:run

4. Configure your MCP client (IDE, or MCP Inspector) to connect to the running server endpoint. If you’re using the provided example, point to http://localhost:port as configured by your server setup.

Notes and tips:

• The MCP server runs via the Symfony console command mcp:server:run; ensure your environment has PHP and Symfony dependencies properly installed.
• The bundle exposes commands to interact with the Symfony Profiler, such as listing recent profiler entries and retrieving details by token. Use these in conjunction with your MCP Inspector to validate data flow.
• If you modify Symfony configuration or enable/disable Debug mode, remember to restart the MCP server so changes take effect.
• Ensure network access from your IDE to the MCP server if running on a remote host or container.
• You can customize environment variables (APP_ENV, APP_DEBUG, etc.) in your deployment setup to match development or production needs.