Инструменты вместо 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"(иначе raiseValueError). Если в нем естьresult, return{"id": ..., "ok": True, "result": ...}. Если в нем естьerror, return{"id": ..., "ok": False, "error": {"code": ..., "message": ...}}. Если нет ничего из этого, raiseValueError.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.
Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке
Это упражнение откроется скоро
Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.
Этот браузер блокирует cookies для learn.floati.life, поэтому завершенные здесь уроки не могут открыться по порядку. Разрешите cookies для этого сайта и перезагрузите страницу.