Mago Language Server, Serena MCP, Symfony, AI Development - Proof of Concept
# Symfony development with Mago, Serena, and AI Mate
A reproducible Docker environment for exploring PHP source, inspecting Symfony
services, and diagnosing requests with coding agents. It includes a pinned
Symfony Demo application, Mago's PHP tools, Serena's semantic Model Context
Protocol (MCP) server, AI Mate inspection tools, and independent checks.
Use it for development in a disposable application or for reproducing the
included coding exercises. The integration is experimental: the image includes
repository patches to Mago and Serena. See [capabilities](docs/CAPABILITIES.md)
for supported paths and the scope of their verification.
## Get started
Install Git, a host Python 3 interpreter, [uv](https://docs.astral.sh/uv/getting-started/installation/),
Node.js for fast tests, and Docker with Compose v2. Host launchers use POSIX user
and group IDs; use Linux or a Linux environment such as WSL2. Hosted acceptance
runs on Ubuntu. See [setup requirements](docs/GETTING-STARTED.md) for platform,
network, and proxy details.
```sh
git clone https://github.com/xormania/mago-serena_v2-poc.git
cd mago-serena_v2-poc
uv sync --frozen --python 3.12.12
./bin/poc fast
./bin/poc up
./bin/poc doctor
```
The first build compiles Rust software and downloads dependencies; allow several
minutes and several GB of memory and disk. No model account or API key is needed
for setup and deterministic checks. Open <http://localhost:8000/en/blog/>.
Edit `workspaces/dev/app/`, mounted at `/app` in the container. The checked-in
`app/` directory is fixture input. **Every `up` invocation runs setup again,
replacing the workspace's dev/test databases and `.env.local`.** Save data and
local settings before repeating it.
## Use the tools
```sh
./bin/poc mago --run dev -- analyze --reporting-format json
./bin/poc exec --run dev -- php vendor/bin/phpunit
./bin/poc mate-prepare --run dev
./bin/mate --run dev -- tools:list --format=json
```
Mago retains native findings and exits; the fixture ha