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-контейнер.SharedSecretMiddleware работает по принципу fail-closed; BearerTokenMiddleware превращает сервер в OAuth 2.1 resource server.tool_call_budget ограничивает число tools/call подряд, чтобы остановить циклы агента.ArgumentMasker для маскирования секретов в аргументах.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.0 | 2026-11-11 |
| v4.1.1 | 2026-10-10 |
| v4.1.0 | 2026-10-09 |
| v4.0.1 | 2026-10-08 |
| v4.0.0 | 2026-10-08 |
| v3.1.1 | 2026-10-07 |
| v3.1.0 | 2026-10-07 |
| v3.0.1 | 2026-10-07 |
| v3.0.0 | 2026-10-07 |
| v2.3.0 | 2026-09-08 |
… и ещё 16 раньше. Все релизы
/ поиск · n N следующее, предыдущее · g G начало, конец · q к индексу