README

⚠️ BETA VERSION - This package is currently in beta. Please report any issues you encounter.

An MCP (Model Context Protocol) server for Symfony projects that provides Claude Code and PhpStorm with advanced functionality.

Features

• 🗄️ Database Tools: List tables, describe structure, execute queries
• 📊 Doctrine Integration: List entities, show foreign keys
• 🛣️ Routing: Display all routes
• 📝 Logs: Read log files, find last errors
• 🎯 Console: Execute Symfony console commands
• ℹ️ App Info: PHP version, Symfony version, database platform, bundles
• ⚙️ Configuration: Get config values, list environment variables
• 📦 14 MCP Tools: Comprehensive toolkit for Symfony development

Installation

1. Install Package

Local in project (recommended):

composer require itsjustvita/symfony-boost --dev

Or globally:

composer global require itsjustvita/symfony-boost

2. Generate Configuration

php vendor/bin/symfony-boost install

This command automatically creates:

• .mcp.json - MCP server configuration
• .claude/settings.local.json - Claude Code permissions

3. Start Claude Code/PhpStorm

The tools are now available! Test with: "List all database tables"

Available Tools

Symfony Boost comes with 14 powerful MCP tools designed specifically for Symfony development:

Application & Configuration

Database Operations

Debugging & Development

Usage

With Claude Code

Simply use natural language commands:

"Show me all tables"
"Describe the 'users' table"
"Execute a SELECT on 'products'"
"List all routes"
"Show the last 50 log entries"

Direct (for debugging)

# Start server (stdio mode)
php vendor/bin/symfony-boost

# Show help
php vendor/bin/symfony-boost --help

# Show installation help
php vendor/bin/symfony-boost install --help

Configuration

.mcp.json Structure

{
  "mcpServers": {
    "symfony-boost": {
      "command": "php",
      "args": ["vendor/bin/symfony-boost"],
      "cwd": "/path/to/project",
      "env": {
        "DATABASE_URL": "mysql://user:pass@localhost/dbname",
        "APP_ENV": "dev"
      }
    }
  }
}

Manual Configuration

If install doesn't work, you can create the files manually:

1. Create .mcp.json with the structure above
2. Create .claude/settings.local.json:

{
  "permissions": {
    "allow": [
      "mcp__symfony-boost__*"
    ]
  },
  "enableAllProjectMcpServers": true,
  "enabledMcpjsonServers": ["symfony-boost"]
}

Security

• READ-ONLY Queries Only: The database_query tool only allows SELECT, SHOW, EXPLAIN, DESCRIBE
• Automatic LIMIT: Queries without LIMIT are automatically limited to 100 rows
• Shell Escaping: All paths are properly escaped
• Trusted Source: Commands come from Claude Code

Troubleshooting

"Tool not available" Error

1. Check if .mcp.json exists and is correct
2. Restart Claude Code
3. Run php vendor/bin/symfony-boost install --force

"DATABASE_URL not found"

1. Make sure .env exists
2. Check if DATABASE_URL is defined in .env
3. Run symfony-boost install again

Server doesn't start

# Test manually
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | php vendor/bin/symfony-boost

# Should return JSON-RPC response

Tools not showing

# List all tools
echo '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | php vendor/bin/symfony-boost

Development

Project Structure

symfony-boost/
├── bin/
│   └── symfony-boost          # Executable
├── src/
│   ├── McpServer.php         # JSON-RPC Server
│   ├── SymfonyBoostServer.php # Tool implementations
│   └── InstallCommand.php     # Install command
├── composer.json
└── README.md

Testing

# Test server manually
php vendor/bin/symfony-boost install --help
php vendor/bin/symfony-boost --help

# Test MCP protocol
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | php vendor/bin/symfony-boost
echo '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | php vendor/bin/symfony-boost

Requirements

• PHP 8.1+
• Symfony 6.0+ or 7.0+
• Doctrine DBAL 3.0+ or 4.0+
• Claude Code or PhpStorm with MCP support

License

MIT

Support

For issues or questions:

1. Check the troubleshooting section
2. Create an issue on GitHub
3. Contact the maintainer

Changelog

1.0.0-beta (Current)

• Initial beta release
• 14 MCP tools for Symfony development
• CLAUDE.md generation with AI development guidelines
• Automatic installation command
• Support for both local and global installation
• Doctrine DBAL 3.x and 4.x compatibility
• New tools: get_config, list_env_vars, last_error, list_bundles

Made with ❤️ for Symfony Developers