Model Context Protocol server for Symfony applications — read-only introspection of routes, services, entities, controllers, database schema, migrations, composer packages and logs
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add symfony-agent --env SYMFONY_MCP_SESSION_SECRET='<SYMFONY_MCP_SESSION_SECRET>' --env SYMFONY_MCP_SESSION_TOKEN='<SYMFONY_MCP_SESSION_TOKEN>' -- npx -y @shakaran/symfony-agent-mcp~/.codex/config.toml
[mcp_servers.symfony-agent]
command = "npx"
args = ["-y", "@shakaran/symfony-agent-mcp"]
env = { SYMFONY_MCP_SESSION_SECRET = "<SYMFONY_MCP_SESSION_SECRET>", SYMFONY_MCP_SESSION_TOKEN = "<SYMFONY_MCP_SESSION_TOKEN>" }
# codex mcp add symfony-agent --env SYMFONY_MCP_SESSION_SECRET='<SYMFONY_MCP_SESSION_SECRET>' --env SYMFONY_MCP_SESSION_TOKEN='<SYMFONY_MCP_SESSION_TOKEN>' -- npx -y @shakaran/symfony-agent-mcp~/.cursor/mcp.json
{
"mcpServers": {
"symfony-agent": {
"command": "npx",
"args": [
"-y",
"@shakaran/symfony-agent-mcp"
],
"env": {
"SYMFONY_MCP_SESSION_SECRET": "<SYMFONY_MCP_SESSION_SECRET>",
"SYMFONY_MCP_SESSION_TOKEN": "<SYMFONY_MCP_SESSION_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"symfony-agent": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@shakaran/symfony-agent-mcp"
],
"env": {
"SYMFONY_MCP_SESSION_SECRET": "<SYMFONY_MCP_SESSION_SECRET>",
"SYMFONY_MCP_SESSION_TOKEN": "<SYMFONY_MCP_SESSION_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"symfony-agent": {
"command": "npx",
"args": [
"-y",
"@shakaran/symfony-agent-mcp"
],
"env": {
"SYMFONY_MCP_SESSION_SECRET": "<SYMFONY_MCP_SESSION_SECRET>",
"SYMFONY_MCP_SESSION_TOKEN": "<SYMFONY_MCP_SESSION_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"symfony-agent": {
"command": "npx",
"args": [
"-y",
"@shakaran/symfony-agent-mcp"
],
"env": {
"SYMFONY_MCP_SESSION_SECRET": "<SYMFONY_MCP_SESSION_SECRET>",
"SYMFONY_MCP_SESSION_TOKEN": "<SYMFONY_MCP_SESSION_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"symfony-agent": {
"command": "npx",
"args": [
"-y",
"@shakaran/symfony-agent-mcp"
],
"env": {
"SYMFONY_MCP_SESSION_SECRET": "<SYMFONY_MCP_SESSION_SECRET>",
"SYMFONY_MCP_SESSION_TOKEN": "<SYMFONY_MCP_SESSION_TOKEN>"
}
}
}
}Environment variables
SYMFONY_MCP_SESSION_SECRETSYMFONY_MCP_SESSION_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.