Symfony Agent MCP
Read-only Symfony introspection: routes, services, entities, Doctrine, security, Twig…
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.0.2
- Listing updated
- 4 days ago
About Symfony Agent MCP
Symfony Agent MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Read-only Symfony introspection: routes, services, entities, Doctrine, security, Twig and more.
Install
Run in a terminal
claude mcp add symfony-agent-mcp --env SYMFONY_MCP_SESSION_SECRET='<SYMFONY_MCP_SESSION_SECRET>' --env SYMFONY_MCP_SESSION_TOKEN='<SYMFONY_MCP_SESSION_TOKEN>' -- npx -y @shakaran/symfony-agent-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"symfony-agent-mcp": {
"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>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"symfony-agent-mcp": {
"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>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"symfony-agent-mcp": {
"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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"symfony-agent-mcp": {
"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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"symfony-agent-mcp": {
"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>"
}
}
}
}Configuration
SYMFONY_MCP_DYNAMIC_TOOLSProgressive tool discovery. Left on, tools/list advertises five discovery meta-tools and the rest become callable once a category is activated (~828 tokens on connect). Set to false to advertise all 1,677 up front (~154,000).SYMFONY_MCP_TOKEN_BUDGETToken ceiling for the schemas a session may have active at once.SYMFONY_MCP_ALLOWED_PATHSColon-separated allowlist of directories the server may read. Any app_path outside them is refused.SYMFONY_MCP_SESSION_SECRETEnables session-token authentication. Unset, authentication is off.SYMFONY_MCP_SESSION_TOKENClient-side token, required only once SYMFONY_MCP_SESSION_SECRET is set.SYMFONY_MCP_AUDITEncrypted audit log of every tool call.SYMFONY_MCP_DLPScan every result for credentials before returning it. Turning this off is reported as CRITICAL by the startup audit.
Pricing
Open source
Symfony Agent MCP FAQ
Is Symfony Agent MCP free?
Yes. Symfony Agent MCP is open source, so you can use and self-host it for free.
How do I add Symfony Agent MCP to Claude Code?
Run this command in your terminal: claude mcp add symfony-agent-mcp --env SYMFONY_MCP_SESSION_SECRET='<SYMFONY_MCP_SESSION_SECRET>' --env SYMFONY_MCP_SESSION_TOKEN='<SYMFONY_MCP_SESSION_TOKEN>' -- npx -y @shakaran/symfony-agent-mcp