PHP MCP

Add php-mcp to your PHP project using Composer. The package is published on Packagist under the name dtyq/php-mcp.

composer require dtyq/php-mcp

Check that all required extensions are enabled in your php.ini. The pcntl extension is required for STDIO transport and is usually available on Linux/macOS but disabled on Windows.

php -m | grep -E 'json|mbstring|openssl|pcntl|curl'

Annotate a PHP method with #[McpTool] to register it as a callable MCP tool. Parameters are validated against a JSON Schema derived from PHP type hints.

<?php
use Dtyq\PhpMcp\Attribute\McpTool;

class MyTools
{
    #[McpTool(description: 'Add two numbers together')]
    public function add(int $a, int $b): array
    {
        return ['result' => $a + $b];
    }
}

Create an Application instance, register your tool classes, and start the server in STDIO mode. The server will listen on stdin/stdout for MCP protocol messages.

<?php
use Dtyq\PhpMcp\Application;

$app = new Application($container, ['sdk_name' => 'my-php-mcp-server']);
$app->registerTool(new MyTools());
$app->runStdio();

Add a configuration entry for your PHP MCP server in your MCP client's config file, pointing to your PHP script with the php binary.

Restart your MCP client and ask the AI to list available tools. Your PHP-defined tools should appear by name with their descriptions.