Полная реализация PHP протокола Model Context Protocol (MCP), обеспечивающая как серверную, так и клиентскую функциональность с поддержкой нескольких транспортных протоколов.

Язык: английский | 中

Ключевые особенности

Последний протокол MCP поддерживает спецификацию MCP 2025-03-26 ** Полная реализация** - Инструменты, ресурсы и оперативная поддержка

• • • Множественные перевозки * * - STDIO , HTTP , потоковый HTTP
• Framework Compatible - Работает с любой совместимой с PSR структурой, встроенной интеграцией Hyperf
• • • Хорошо документировано * * - Всесторонние руководства на английском и китайском языках

Быстрый старт

###Установка

Hyperfix Framework - быстрая интеграция

Если вы используете фреймворк Hyperf, интеграция очень проста:

Аннотированная регистрация:

** Продвинутые варианты**:

• AuthenticatorInterface - Пользовательская аутентификация
• HttpTransportAuthenticatedEvent - Динамический инструмент/регистрация ресурсов Система аннотации - инструменты, ресурсы и подсказки для автоматической регистрации

Полное руководство по интеграции Hyperf

Базовый сервер

Базовый пример клиента

** Альтернативные методы**:

Документация

PHP MCP

A complete PHP implementation of the Model Context Protocol (MCP), providing both server and client functionality with support for multiple transport protocols.

Language: English | 简体中文

✨ Key Features

• 🚀 Latest MCP Protocol - Supports MCP 2025-03-26 specification
• 🔧 Complete Implementation - Tools, resources, and prompts support
• 🔌 Multiple Transports - STDIO ✅, HTTP ✅, Streamable HTTP 🚧
• 🌐 Framework Compatible - Works with any PSR-compliant framework, built-in Hyperf integration
• 📚 Well Documented - Comprehensive guides in English and Chinese

🚀 Quick Start

Installation

composer require dtyq/php-mcp

Hyperf Framework Quick Integration

If you’re using Hyperf framework, integration is extremely simple:

// Just one line of code!
Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp', function () {
    return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handle('default');
});

Annotation-Based Registration:

class CalculatorService
{
    #[McpTool(description: 'Mathematical calculations')]
    public function calculate(string $operation, int $a, int $b): array
    {
        return ['result' => match($operation) {
            'add' => $a + $b,
            'multiply' => $a * $b,
            default => 0
        }];
    }
    
    #[McpResource(description: 'System information')]
    public function systemInfo(): TextResourceContents
    {
        return new TextResourceContents('mcp://system/info', 
            json_encode(['php' => PHP_VERSION]), 'application/json');
    }
}

Advanced Options:

• 🔐 AuthenticatorInterface - Custom authentication
• 📊 HttpTransportAuthenticatedEvent - Dynamic tool/resource registration
• 📝 Annotation System - Auto-register tools, resources and prompts

👉 View Complete Hyperf Integration Guide

Basic Server Example

<?php
require_once 'vendor/autoload.php';

use Dtyq\PhpMcp\Server\McpServer;
use Dtyq\PhpMcp\Shared\Kernel\Application;

// Create server with simple container
$container = /* your PSR-11 container */;
$app = new Application($container, ['sdk_name' => 'my-server']);
$server = new McpServer('my-server', '1.0.0', $app);

// Add a tool
$server->registerTool(
    new \Dtyq\PhpMcp\Types\Tools\Tool('echo', [