pinoox-mcp

MCP server for the Pinoox PHP HMVC platform — gives any MCP-compatible AI client real project context (Cursor, Claude Desktop, VS Code, Windsurf, Zed, and more).

Supports multi-app platform (php pinoox) and single-app pinx (pinoox/pinx-cli) workflows.

Official docs: github.com/pinoox/docs

Features

Documentation (no PINOOX_ROOT required)

Project introspection (requires PINOOX_ROOT)

Resources

• pinoox://docs/index — documentation table of contents

• pinoox://docs/{lang}/{path} — individual doc pages

• pinoox://conventions — Pinoox coding conventions for AI

Prompts

• create-pinoox-app — scaffold a new app

• pinx-workflow — pinx-cli day-to-day commands

Related MCP server: MCP Perplexity Pro

Requirements

• Node.js 18+

• PHP 8.1+ (project tools)

• An MCP-compatible client (IDE, desktop app, or CLI agent)

• Pinoox 3.x platform or single-app pinx project

Install

npm (recommended)

npx -y pinoox-mcp

Or install globally:

npm install -g pinoox-mcp

npm package: npmjs.com/package/pinoox-mcp

From source

git clone https://github.com/pinoox/pinoox-mcp.git
cd pinoox-mcp
npm install
npm run build

MCP client configuration

pinoox-mcp uses stdio transport — any client that supports MCP servers can connect. Recommended config (from examples/mcp.json):

{
  "mcpServers": {
    "pinoox": {
      "command": "npx",
      "args": ["-y", "pinoox-mcp"],
      "env": {
        "PINOOX_ROOT": "/absolute/path/to/your/project"
      }
    }
  }
}

For local development, use node with the path to build/index.js instead of npx.

PINOOX_ROOT works for both:

• Platform: directory with index.php + pinoox

• Single-app: directory with app.php + bin/pinx

Optional alias: PINX_ROOT (same as PINOOX_ROOT).

Where to put the config

AI agent rules

Copy rules/AGENTS.md into your project or add it to your client's system instructions / rules (Cursor Rules, Claude project instructions, etc.).

Environment variables

Allowed CLI commands

run_cli only permits read-only commands. Lists differ by project kind:

Platform (php pinoox): list, app:list, route:actions, migrate:status, pinker:status, log:view, version, …

Single-app (pinx): list, info, doctor, routes, migrate:st, pinker:st, deps:st, fe:info, log:view, …

Destructive commands (migrate, app:delete, cache:clear, …) are blocked.

Development

npm run dev    # watch TypeScript
npm run build  # compile to build/
npm start

License

MIT