MCP Bundle

← MCP Bundle

Ashterix

docs: English JsonRpcBundle docs, REST and MCP Bundle sections, package cards

uk/docs/api/mcp-bundle/README.md +1 −1

MCP Bundle

<include>(docs/api/mcp-bundle/.info.md)

<include>(docs/api/mcp-bundle/.info.md)

MCP-сервер (Model Context Protocol) для JsonRpcBundle: методи вашого JSON-RPC API стають інструментами (tools), які AI-агенти — Claude Code, Cursor, Gemini CLI, OpenAI — викликають через Streamable HTTP.

Це тонкий адаптер, як і REST Bundle: бізнес-логіка лишається в RPC-сервісах, а кожен виклик інструмента — звичайний RPC-запит, який виконує JsonRpcBundle. Перетворення параметрів, DTO, валідація, кеш, блокування, події та формат помилок — ті самі, що й на /rpc.

Від методу до інструмента

Ваш код

use Ufo\JsonRpcBundle\ApiMethod\Interfaces\IRpcService;
use Ufo\McpBundle\Attribute\McpTool;
use Ufo\RpcObject\RPC;

#[RPC\Info('Catalog')]
#[RPC\APIGroups(['mcp'], withDefault: false)]
final class CatalogProcedure implements IRpcService
{
    /**
     * Search products by name.
     * @param string $query Part of the product name
     */
    #[McpTool(readOnlyHint: true)]
    public function search(string $query, int $limit = 10): array
    {
        // ...
    }
}

tools/list на /mcp (скорочено)

{
    "name": "Catalog.search",
    "description": "Search products by name.",
    "inputSchema": {
        "type": "object",
        "properties": {
            "query": {"type": "string", "description": "Part of the product name"},
            "limit": {"type": "integer", "default": 10}
        },
        "additionalProperties": false,
        "required": ["query"]
    },
    "annotations": {"readOnlyHint": true}
}

Більше нічого писати не треба:

  • POST /mcp — MCP-сервер з інструментом Catalog.search, захищений RPC-токеном;
  • GET /mcp/manifest/claude.json віддає готову конфігурацію Claude Code для підключення (так само cursor, gemini, openai);
  • GET /mcp/server.json — документ для публікації в MCP Registry.

Можливості

  • Що стає інструментом — визначає група API. Кожен метод групи — інструмент з назвою RPC-методу. Кілька ендпоінтів (/mcp, /mcp/internal, …) поруч, кожен зі своїми методами (Налаштування).
  • Версії API. /mcp/v2 обслуговує версію 2 групи.
  • Роботу робить ядро. Виклик інструмента проходить через RpcExecutor JsonRpcBundle (Інструменти).
  • Схеми й тексти для агентів. inputSchema / outputSchema з метаданих методів; назви й описи з перекладів ядра за Accept-Language, зокрема окремо для групи; підказки #[McpTool].
  • Обидві епохи протоколу MCP на одному URL: із сесіями (сесії в кеш-пулі ядра) і stateless 2026-07-28 (HTTP і безпека).
  • Та сама безпека. RPC-токени ядра (401/403), 404 для вимкненої групи чи відсутньої версії, CORS, захист від DNS rebinding, ліміт тіла запиту.
  • Discovery. server.json для MCP Registry і маніфести клієнтів (server.json і маніфести).
  • Розширюваність. Перевірка доступності, політика доступу, власні маніфести клієнтів (Для розробників).

Обмеження

  • Без OAuth: доступ — RPC-токен у заголовку (HTTP і безпека).
  • Лише tools: без MCP resources і prompts. SDK типово оголошує capabilities logging і completions, але бандл їх не використовує.
  • Без повідомлень з ініціативи сервера (GET на ендпоінт відповідає 405) і без асинхронних викликів чи webhook через MCP.

<include>(change_log/latest.md)

З чого почати

  1. Встановіть бандл і додайте маршрути MCP.
  2. Додайте RPC-методи в групу ендпоінта — і перевірте tools/list.
  3. Налаштуйте сервер групи і, за потреби, CORS і хости.
  4. Підключіть клієнта за маніфестом.

uk/docs/api/mcp-bundle/.info.md +17 −62

Скачати

Packagist
GitHub

Актуальна версія

Категорія

API

Тип

Symfony Bundle

Залежності

php_version json_rpc_bundle mcp_sdk

Інші відомості

License Size

Версія Завантаження Зірки

composer require ufo-tech/mcp-bundle
  • PHP 8.4+
  • Symfony 7.2+ · 8
  • Основа JsonRpcBundle 10.4.3+ · mcp/sdk 0.8
  • Протокол MCP · Streamable HTTP
  • Тип Symfony Bundle
  • Категорія API · AI
  • Ліцензія MIT

GitHub Packagist Історія змін Відомі помилки