Php Mcp Sdk

PHP MCP SDK

[](https://packagist.org/packages/dalehurley/php-mcp-sdk) [](https://packagist.org/packages/dalehurley/php-mcp-sdk) [](https://packagist.org/packages/dalehurley/php-mcp-sdk) [](https://github.com/dalehurley/php-mcp-sdk/blob/main/LICENSE) [](https://github.com/dalehurley/php-mcp-sdk/actions)

PHP implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

✨ Features

• 🚀 Complete MCP Protocol Support - Full implementation of the MCP specification
• 🔧 Type-Safe - Leverages PHP 8.1+ type system with enums, union types, and strict typing
• ⚡ Async First - Built on Amphp for non-blocking I/O operations
• 🔌 Multiple Transports - STDIO, HTTP Streaming, and WebSocket
• 🔐 OAuth 2.0 Ready - Built-in authentication with PKCE support
• 🏗️ Framework Integration - Laravel, Symfony, and PSR-compatible design
• 📦 PSR Compliant - Follows PSR-4, PSR-7, PSR-12, and PSR-15 standards
• 🛡️ Production Ready - Comprehensive error handling, logging, and monitoring
• 🤖 Agentic AI Support - Build intelligent AI agents with MCP tool orchestration
• 🏭 Real-World Examples - Complete applications (Blog CMS, Task Manager, API Gateway)
• 📚 Comprehensive Documentation - Best-in-class documentation with tested examples
• 🧪 Automated Testing - All documentation examples are automatically tested

📋 Requirements

• PHP 8.1+ - Leverages modern PHP features
• Composer - For dependency management
• ext-json - JSON processing
• ext-mbstring - String handling

🚀 Installation

Via Composer

composer require dalehurley/php-mcp-sdk

Development Version

composer require dalehurley/php-mcp-sdk:dev-main

⚡ Quick Start

Creating an MCP Server

#!/usr/bin/env php
tool(
    'say_hello',
    'Says hello to someone',
    [
        'type' => 'object',
        'properties' => [
            'name' => [
                'type' => 'string',
                'description' => 'Name of the person to greet'
            ]
        ],
        'required' => ['name']
    ],
    function (array $args): array {
        $name = $args['name'] ?? 'World';

        return [
            'content' => [
                [
                    'type' => 'text',
                    'text' => "Hello, {$name}! 👋 Welcome to MCP!"
                ]
            ]
        ];
    }
);

// Start the server
async(function () use ($server) {
    echo "🚀 Hello World MCP Server starting...\n";

    $transport = new StdioServerTransport();
    $server->connect($transport)->await();
})->await();

Creating an MCP Client

#!/usr/bin/env php
 'php',
    'args' => [__DIR__ . '/weather-server.php']
]);

Amp\async(function() use ($client, $transport) {
    try {
        // Connect to server
        yield $client->connect($transport);
        echo "✅ Connected to weather server\n";

        // List available tools
        $result = yield $client->listTools();
        echo "📋 Available tools:\n";
        foreach ($result['tools'] as $tool) {
            echo "  - {$tool['name']}: {$tool['description']}\n";
        }

        // Call the weather tool
        $result = yield $client->callTool('get-weather', [
            'location' => 'London, UK'
        ]);

        echo "\n🌤️  Weather result:\n";
        echo $result['content'][0]['text'] . "\n";

        yield $client->close();

    } catch (\Exception $error) {
        echo "❌ Error: " . $error->getMessage() . "\n";
    } finally {
        Loop::stop();
    }
});

Loop::run();

Test Your Implementation

# Run the hello-world server
php examples/getting-started/hello-world-server.php

# Test with Claude Desktop by adding to your configuration:
{
  "mcpServers": {
    "hello-world": {
      "command": "php",
      "args": ["/path/to/examples/getting-started/hello-world-server.php"]
    }
  }
}

# Or test with the MCP Inspector (Node.js required)
npx @modelcontextprotocol/inspector examples/getting-started/hello-world-server.php

🎯 Examples Overview

The PHP MCP SDK includes 20+ comprehensive examples across all skill levels:

🎓 Getting Started (4 examples)

• Hello World - Simplest possible server and client
• Calculator - Multi-tool server with math operations
• File Reader - Secure file system integration
• Weather Client - External API integration patterns

🏗️ Framework Integration (2 examples)

• Laravel Integration - Complete Laravel patterns with service container
• Symfony Integration - Full Symfony integration with DI container

🤖 Agentic AI (4 examples)

• Working Agentic Demo - Rule-based agent reasoning
• Personal Assistant - Multi-MCP server coordination
• Multi-Agent Orchestrator - Specialized agent coordination
• OpenAI Integration - LLM-powered intelligent agents

🏭 Real-World Applications (5 examples)

• Blog CMS - Complete content management system
• Task Manager - Project management with analytics
• API Gateway - Enterprise API orchestration
• Code Analyzer - Development quality tools
• Data Pipeline - ETL and data processing

🏢 Enterprise & Production (3 examples)

• Docker Deployment - Production containerization
• Microservices Architecture - Distributed systems patterns
• Monitoring & Observability - Production monitoring

All examples are tested and working! 🎉

Framework Integration

The PHP MCP SDK is designed to work with any PHP framework through its PSR-compliant architecture.

Laravel Integration

You can use the core PHP MCP SDK directly in Laravel applications:

composer require dalehurley/php-mcp-sdk

// In a Laravel controller or service
use MCP\Server\McpServer;
use MCP\Types\Implementation;

class McpController extends Controller
{
    public function createServer()
    {
        $server = new McpServer(
            new Implementation('my-laravel-app', '1.0.0')
        );

        // Register your tools, resources, and prompts
        $server->tool('search-users', 'Search for users', [
            'type' => 'object',
            'properties' => [
                'query' => ['type' => 'string', 'description' => 'Search query']
            ]
        ], function($params) {
            return [
                'content' => [
                    [
                        'type' => 'text',
                        'text' => json_encode(User::where('name', 'like', "%{$params['query']}%")->get())
                    ]
                ]
            ];
        });

        return $server;
    }
}

For a complete Laravel package with service providers, Artisan commands, and Laravel-specific features, see the separate laravel-mcp-sdk package.

📚 Documentation

The most comprehensive MCP SDK documentation in the ecosystem is available in the [docs/](docs/) directory:

🎓 Getting Started (Beginner-Friendly)

• [📖 Complete Documentation](docs/README.md) - Start here for full overview
• [⚡ Quick Start Guide](docs/getting-started/quick-start.md) - Get up and running in 5 minutes
• [🏗️ First Server](docs/getting-started/first-server.md) - Build your first server in 10 minutes
• [📱 First Client](docs/getting-started/first-client.md) - Build your first client in 10 minutes
• [🧠 Understanding MCP](docs/getting-started/understanding-mcp.md) - Deep dive into MCP protocol
• [💡 Core Concepts](docs/getting-started/concepts.md) - Understand MCP fundamentals
• [🔧 Troubleshooting](docs/getting-started/troubleshooting.md) - Common issues and solutions

🏗️ Implementation Guides

• [📱 Creating Clients](docs/guides/client-development/creating-clients.md) - Build MCP clients
• [🔐 Security Best Practices](docs/guides/security/security-best-practices.md) - OAuth 2.0 and security
• [🛠️ Tools Guide](docs/guides/server-development/tools-guide.md) - Server development with tools
• [📚 Resources Guide](docs/guides/server-development/resources-guide.md) - Server development with resources
• [🤖 OpenAI Integration](docs/guides/openai-tool-calling.md) - AI tool calling
• [📊 FullCX Integration](docs/guides/fullcx-integration.md) - Product management

🤖 Agentic AI Development

• [🧠 Build Agentic AI Agents](docs/tutorials/specialized/agentic-ai-agents.md) - Complete agentic AI tutorial
• [🎯 Agent Examples](examples/agentic-ai/) - Working agent implementations
• [🔗 Multi-Agent Systems](examples/agentic-ai/multi-agent-orchestrator.php) - Agent coordination

🏭 Real-World Applications

• [📝 Blog CMS](examples/real-world/blog-cms/blog-cms-mcp-server.php) - Complete content management system
• [📋 Task Manager](examples/real-world/task-manager/task-manager-mcp-server.php) - Project management system
• [🚀 API Gateway](examples/real-world/api-gateway/api-gateway-mcp-server.php) - Enterprise API management
• [🔍 Code Analyzer](examples/real-world/code-analyzer/code-analyzer-mcp-server.php) - Development quality tools
• [🔄 Data Pipeline](examples/real-world/data-pipeline/data-pipeline-mcp-server.php) - ETL and data processing

🏢 Enterprise & Production

• [🐳 Docker Deployment](examples/enterprise/docker-mcp-deployment.php) - Containerization
• [🏗️ Microservices](examples/enterprise/microservices-mcp-architecture.php) - Distributed systems
• [📊 Monitoring](examples/enterprise/monitoring-observability-mcp.php) - Observability

📖 API Reference

• [🔧 Server API](docs/api/server.md) - Complete server API
• [📡 Client API](docs/api/client.md) - Complete client API
• [📋 Types & Schemas](docs/api/types/core-types.md) - Type system reference

🔄 Migration & Examples

• [💻 Working Examples](examples/README.md) - 20+ tested examples
• [🔄 TypeScript Migration](docs/migration/from-typescript.md) - Migration guide

Testing

# Run tests
composer test

# Run tests with coverage
composer test-coverage

# Run static analysis
composer phpstan
composer psalm

# Fix code style
composer cs-fix

# Run all checks
composer check

Contributing

Contributions are welcome! Please read our [Contributing Guide](docs/contributing.md) for details.

Changelog

All notable changes to this project are documented in the [CHANGELOG.md](CHANGELOG.md). Please update it when making changes.

License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

Acknowledgments

• Based on the MCP TypeScript SDK
• Built with Amphp for async operations
• Uses Respect/Validation for schema validation

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: dalehurley
• Source: dalehurley/php-mcp-sdk
• License: MIT
• Homepage: https://phpmcpsdk.com

Install and usage instructions live in the source repository linked above.