Skip to content
YII3-MCP(3)Руководство по PHP-библиотекам rasuvaeffYII3-MCP(3)

ИМЯ ​

yii3-mcp — сервер Model Context Protocol для Yii3 на официальном mcp/sdk поверх PSR-15

ОБЗОР ​

$ composer require rasuvaeff/yii3-mcp

final readonly class OrderTools{    public function __construct(private OrderRepository $orders) {}     /**     * Returns the current status of an order.     */    #[McpTool(name: 'order.status')]    public function status(string $orderId): string    {        return $this->orders->get($orderId)->status->value;    }}

ОПИСАНИЕ ​

Сервер Model Context Protocol для Yii3, построенный на официальном mcp/sdk и работающий поверх PSR-15.

Чтобы отдать операции приложения ИИ-агентам как tools, resources и prompts, нужны Streamable HTTP эндпоинт, tools, разрешаемые через контейнер, и защита от циклов агента и утечек секретов.

  • Методы с #[McpTool], #[McpResource] и #[McpPrompt] разрешаются через DI-контейнер.
  • На одном эндпоинте обслуживает ревизии handshake от 2024-11-05 до 2025-11-25 и stateless 2026-07-28.
  • SharedSecretMiddleware работает по принципу fail-closed; BearerTokenMiddleware превращает сервер в OAuth 2.1 resource server.
  • tool_call_budget ограничивает число tools/call подряд, чтобы остановить циклы агента.
  • Интерсепторы для rate limit, ограничения размера ответа и кеширования через PSR-16, плюс помощник ArgumentMasker для маскирования секретов в аргументах.
  • Видимость tools, prompts и resources для каждой сессии.
  • OpenApiServerConfigurator пробрасывает REST-операции из allow-list как tools.
  • McpTester, SchemaSnapshot, mcp:doctor, mcp:list и stdio mcp:serve.

ПРИМЕРЫ ​

Сообщает MCP-клиентам, что инструмент изменяет данные и деструктивен, через штатные аннотации SDK.

#[McpTool(    name: 'order.cancel',    annotations: new ToolAnnotations(        readOnlyHint: false,        destructiveHint: true,        idempotentHint: true,        openWorldHint: false,    ),)]public function cancel(string $orderId): string{    $this->orders->cancel($orderId);     return 'cancelled';}

Ограничивает число подряд идущих tools/call: зациклившийся агент получает ошибку вместо нагрузки на приложение.

'rasuvaeff/yii3-mcp' => [    'tool_call_budget' => [        'calls' => 50,0 = unlimited (default)        'window' => 3600,seconds, stateless era only    ],],

Тестирует инструменты в процессе через реальный Streamable HTTP-путь, без сервера и stdio.

$tester = new McpTester($server, $psr17, $psr17, $psr17); $result = $tester->callTool('order.status', ['orderId' => '42']);$this->assertSame('paid', $result['content'][0]['text']); $tester->listTools();every paginated tool definition$tester->listResources();every resource definition$tester->readResource('app://x');resource contents

СМОТРИТЕ ТАКЖЕ ​

ПакетЧто добавляет
yii3-mcp-rbac-bridge(3)RBAC по пользователю на tools
yii3-mcp-audit-log-bridge(3)Audit log каждого вызова
yii3-mcp-telemetry-bridge(3)Трассировки тех же вызовов

ОШИБКИ ​

mcp/sdk экспериментален до 1.0, отсюда pin ~0.10.0. Бюджет вызовов tools защищает от циклов, а не служит квотой клиента. В stateless-режиме без SharedSecretMiddleware все анонимные вызывающие делят один бюджет.

ЗАВИСИМОСТИ

от него зависят: yii3-mcp-audit-log-bridge(3), yii3-mcp-rbac-bridge(3), yii3-mcp-telemetry-bridge(3)

ИСТОРИЯ

Первый релиз v1.0.0 — 2026-07-04, всего релизов: 26.

v5.0.02026-11-11
v4.1.12026-10-10
v4.1.02026-10-09
v4.0.12026-10-08
v4.0.02026-10-08
v3.1.12026-10-07
v3.1.02026-10-07
v3.0.12026-10-07
v3.0.02026-10-07
v2.3.02026-09-08

… и ещё 16 раньше. Все релизы

rasuvaeff/yii3-mcp 5.0.0мутационный порог 97%зависят пакетов 3YII3-MCP(3)

/ поиск · n N следующее, предыдущее · g G начало, конец · q к индексу