Программа курса Урок 139 из 250 · Структурированные ответы и вызов функций/инструментов
Структурированные ответы и вызов функций/инструментов

Инструменты вместо MCP (Model Context Protocol)

Когда в вашем приложении появляется больше одного инструмента, каждый поставщик моделей придумывает свою структуру JSON для вызова их, и в итоге вам приходится писать адаптер для каждого провайдера. Model Context Protocol (MCP) - это открытый стандарт, который решает эту проблему. Это JSON-RPC 2.0 протокол передачи данных для предоставления tools (функций, которые может вызывать модель), resources (данных, которые она может читать), и prompts любому клиенту модели. Напишите MCP сервер один раз, и любой MCP-совместимый клиент (ассистент в IDE, десктопное приложение, агент) сможет его использовать.

Каждое сообщение это JSON-RPC 2.0, который является крошечным фиксированным конвертом. request всегда содержит четыре ключа:

{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
 "params": {"name": "add", "arguments": {"a": 2, "b": 3}}}

id связывает ответ с его запросом. Сервер отвечает с response который повторяет тот же id и несет either либо result or объект error, никогда оба сразу:

{"jsonrpc": "2.0", "id": 1, "result": {"content": [{"type": "text", "text": "5"}], "isError": false}}
{"jsonrpc": "2.0", "id": 1, "error": {"code": -32601, "message": "Method not found"}}

Отрицательные коды это стандарт JSON-RPC: -32601 это "method not found", -32602 это "invalid params" и так далее. Результат tools/call всегда имеет такую форму: content список блоков (text, images и так далее) плюс isError. Инструмент который запустился но завершился ошибкой (например, плохое название города) отвечает isError: true в обычном результате, чтобы модель могла прочитать ошибку; объект JSON-RPC error предназначен для проблем протокола таких как неизвестный метод.

Сессия

A начинается с handshake: клиент отправляет initialize запрос (его версию протокола, возможности и имя), сервер отвечает своими возможностями, и клиент подтверждает это через notifications/initialized уведомление (сообщение без id, так как на него никто не отвечает). Только после этого клиент discover инструменты путем вызова tools/list с пустыми параметрами; сервер возвращает список описаний инструментов.

A настоящий MCP сервер работает через stdio или HTTP и соединяет это с SDK; здесь мы строим и парсим сообщения с помощью модуля json из стандартной библиотеки, чтобы формат передачи был конкретным. Вы пишете три функции.

  • build_request(id, method, params) -> JSON строка для конверта {"jsonrpc": "2.0", "id": id, "method": method, "params": params}. Используйте json.dumps.
  • parse_response(text) -> json.loads текст, требуется jsonrpc == "2.0" (иначе raise ValueError). Если в нем есть result, return {"id": ..., "ok": True, "result": ...}. Если в нем есть error, return {"id": ..., "ok": False, "error": {"code": ..., "message": ...}}. Если нет ничего из этого, raise ValueError.
  • list_tools_request(id) -> запрос на поиск инструментов: build_request с методом "tools/list" и пустым params {}.

Так как build_request возвращает строку, тесты парсят ее обратно с помощью json.loads и сравнивают словарь, поэтому порядок ключей не важен. Убедитесь, что результат и ошибка проходят туда и обратно, запрос discovery имеет правильный метод, а сообщение без jsonrpc или без result и error вызывает ошибку.

Твоя очередь

Создайте и разоберите сообщения JSON-RPC 2.0 в стиле MCP с помощью модуля json. build_request(id, method, params) возвращает JSON строку для {"jsonrpc": "2.0", "id", "method", "params"}. parse_response(text) загружает текст, требует jsonrpc == "2.0" (иначе вызывает ValueError) и возвращает {"id", "ok": True, "result"} для результата или {"id", "ok": False, "error": {"code", "message"}} для ошибки, вызывая исключение, если нет ни того, ни другого. list_tools_request(id) возвращает запрос обнаружения tools/list (отправляется после рукопожатия) с пустыми params.

Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке

Это упражнение откроется скоро

Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.