phpgraph MCP server

phpgraph

A knowledge graph of your PHP codebase, for AI coding agents. Static analysis served over MCP to Sherpa, Claude Code, Codex, Cursor and any MCP client. No LLM, no network, no embeddings: deterministic facts, each with a confidence level.

English · Français

Why phpgraph?

An AI agent dropped into an unfamiliar PHP project reads files one by one and greps for names. It misses what matters most in a real codebase: who calls what, which handler receives a message, which controller serves a route, what breaks if a method changes, and which layer depends on which.

phpgraph parses the whole project once (with nikic/php-parser) and answers those questions from a graph:

• Deterministic facts, not guesses. Every relation is EXTRACTED (read in the code), INFERRED (resolved from declared types) or AMBIGUOUS (a guess, labelled as such).
• It says what it does not know. Unresolved calls, missing vendor/, messages without handlers: the gaps are reported, so the agent knows when to read the code itself.
• Built for DDD and hexagonal architecture, then microservices, then PHP in general: Symfony, Laravel, Ecotone, PrestaShop, WordPress, or plain PHP.
• Private by design. Your code never leaves your machine, and phpgraph never executes it: it only parses it.

Features

Shortened. The full README is on GitHub.