PHPackages                             itsjustvita/symfony-boost - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. itsjustvita/symfony-boost

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

itsjustvita/symfony-boost
=========================

MCP Server für Symfony und Claude Code (PhpStorm)

1.0.0-beta.6(6mo ago)19MITPHPPHP &gt;=8.1

Since Oct 17Pushed 6mo agoCompare

[ Source](https://github.com/itsjustvita/symfony-boost)[ Packagist](https://packagist.org/packages/itsjustvita/symfony-boost)[ RSS](/packages/itsjustvita-symfony-boost/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (7)Used By (0)

Symfony Boost MCP Server
========================

[](#symfony-boost-mcp-server)

[![Latest Version](https://camo.githubusercontent.com/52c9e57affae5e235ee54e4c3a7d65f8aa9ca496b5fe86834357c07295706696/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6974736a757374766974612f73796d666f6e792d626f6f73742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/itsjustvita/symfony-boost)[![Total Downloads](https://camo.githubusercontent.com/ed53b67140e852d4332465b6e53f86ddfd00c2eb7825c5831d547b6604ac4ce2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6974736a757374766974612f73796d666f6e792d626f6f73742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/itsjustvita/symfony-boost)[![License](https://camo.githubusercontent.com/2d3e4144048571c3c1bf7640277537d0fc64f2070696478c817336d4fcf25663/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6974736a757374766974612f73796d666f6e792d626f6f73742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/itsjustvita/symfony-boost)[![PHP Version](https://camo.githubusercontent.com/46003f73a0787c2e285cd94dac4e45daea59f3dd2898e5b316db5d91dd277c21/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6974736a757374766974612f73796d666f6e792d626f6f73742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/itsjustvita/symfony-boost)

> **⚠️ 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
--------

[](#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
------------

[](#installation)

### 1. Install Package

[](#1-install-package)

**Local in project (recommended):**

```
composer require itsjustvita/symfony-boost --dev
```

**Or globally:**

```
composer global require itsjustvita/symfony-boost
```

### 2. Generate Configuration

[](#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

[](#3-start-claude-codephpstorm)

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

Available Tools
---------------

[](#available-tools)

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

### Application &amp; Configuration

[](#application--configuration)

ToolDescription`application_info`Shows PHP version, Symfony version, database info`get_config`Get configuration values using dot notation`list_env_vars`Lists all environment variables from .env files`list_bundles`Lists all installed Symfony bundles### Database Operations

[](#database-operations)

ToolDescription`list_tables`Lists all database tables`describe_table`Shows table structure (columns, indexes)`list_entities`Lists all Doctrine entities`get_table_sizes`Shows number of rows per table`show_foreign_keys`Shows all foreign key constraints`database_query`Executes READ-ONLY SQL queries### Debugging &amp; Development

[](#debugging--development)

ToolDescription`list_routes`Lists all Symfony routes`read_logs`Reads the last N log entries`last_error`Reads the last error from application logs`console_command`Executes Symfony console commandsUsage
-----

[](#usage)

### With Claude Code

[](#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)

[](#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
-------------

[](#configuration)

### .mcp.json Structure

[](#mcpjson-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

[](#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
--------

[](#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
---------------

[](#troubleshooting)

### "Tool not available" Error

[](#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"

[](#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

[](#server-doesnt-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

[](#tools-not-showing)

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

Development
-----------

[](#development)

### Project Structure

[](#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

[](#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
------------

[](#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
-------

[](#license)

MIT

Support
-------

[](#support)

For issues or questions:

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

Changelog
---------

[](#changelog)

### 1.0.0-beta (Current)

[](#100-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**

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance67

Regular maintenance activity

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

6

Last Release

200d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0a417b33e6929772283457feb4d3271eab5571a5d8bc078bbb6f741022e4206c?d=identicon)[itsjustvita](/maintainers/itsjustvita)

---

Top Contributors

[![itsjustvita](https://avatars.githubusercontent.com/u/21318499?v=4)](https://github.com/itsjustvita "itsjustvita (9 commits)")

### Embed Badge

![Health badge](/badges/itsjustvita-symfony-boost/health.svg)

```
[![Health](https://phpackages.com/badges/itsjustvita-symfony-boost/health.svg)](https://phpackages.com/packages/itsjustvita-symfony-boost)
```

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[phpro/soap-client

A general purpose SoapClient library

8885.6M46](/packages/phpro-soap-client)[symplify/monorepo-builder

Not only Composer tools to build a Monorepo.

5205.3M82](/packages/symplify-monorepo-builder)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
