Skip to content
MCP server

Symfony Agent MCP

Read-only Symfony introspection: routes, services, entities, Doctrine, security, Twig…

Runs locallyStatus and history
Install
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-mcp

Add 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