README

MCP (Model Context Protocol) server for Nette application introspection. Allows AI assistants to inspect your Nette application's DI container, database schema, routing, and more.

Installation

With Claude Code and the Nette plugin:

/install-mcp-inspector

Or manually:

composer require nette/mcp-inspector

After installation, restart Claude Code session to activate the MCP server.

Available Tools

DI Container

Tool	Description
`di_get_services`	List all registered services with types and autowiring info
`di_get_service`	Get details of a specific service (factory, setup calls, tags)

Database

Tool	Description
`db_get_tables`	List all database tables
`db_get_columns`	Get columns of a specific table (types, nullable, primary key, foreign keys)
`db_get_relationships`	Get foreign key relationships between all tables (belongsTo, hasMany)

Router

Tool	Description
`router_get_routes`	List all registered routes with masks and defaults
`router_match_url`	Match URL to presenter/action (e.g., "/article/123")
`router_generate_url`	Generate URL for presenter/action (e.g., "Article:show")

Configuration

Create mcp-config.neon in your project root (optional):

# Path to Bootstrap file (defaults to app/Bootstrap.php)
bootstrap: app/Bootstrap.php

# Bootstrap class name (defaults to App\Bootstrap)
bootstrapClass: App\Bootstrap

# Custom toolkits
toolkits:
    - App\Mcp\MyCustomToolkit

Creating Custom Toolkits

use Mcp\Capability\Attribute\McpTool;
use Nette\McpInspector\Toolkit;
use Nette\McpInspector\Bridge\BootstrapBridge;

class MyToolkit implements Toolkit
{
    public function __construct(
        private BootstrapBridge $bridge,
    ) {}

    /**
     * Tool description from PHPDoc.
     * @param string $param Parameter description
     */
    #[McpTool(name: 'my_tool')]
    public function myMethod(string $param): array
    {
        return ['result' => 'data'];
    }
}

toolkits:
    - App\Mcp\MyToolkit

Standalone Usage

CLI Mode

php vendor/bin/mcp-inspector

HTTP Mode

Copy www/mcp-inspector.php to your web root for HTTP-based MCP access.

Manual MCP Configuration

If not using the Nette plugin, add to your project's .mcp.json:

{
    "mcpServers": {
        "nette-inspector": {
            "command": "php",
            "args": ["vendor/bin/mcp-inspector"]
        }
    }
}

Requirements

PHP 8.2+
Nette Framework 3.2+

nette / mcp-inspector

Maintainers

Details