Бесплатный урок

Контракт read-only MCP

Контракт read-only MCP — Минимальный read-only MCP server. Host, client и server; Tool и resource имеют разные роли; Текущая SDK-линия. Практическое задание: Практика: Контракт read-only MCP.

Демо-версия. Материалы проходят редакторскую проверку.

Что рассмотрим

  • Host, client и server
  • Tool и resource имеют разные роли
  • Текущая SDK-линия

Host, client и server

MCP описывает обмен между AI-приложением и сервером данных либо инструментов. Host управляет пользователем и моделью, client поддерживает соединение с конкретным server, server объявляет разрешённые возможности. Протокол сам не даёт доступ ко всему компьютеру и не оплачивает модель. Учебный server возвращает лишь две выдуманные операционные записи из памяти. Он не читает home, не выполняет shell и не имеет сетевого клиента. Маленькая поверхность позволяет проверить весь маршрут до подключения настоящего хранилища.

Tool и resource имеют разные роли

Tool lookup_note принимает noteId и возвращает запись; resource lab://policy имеет постоянный URI и читается как контекст. Resource не является браузерным URL и не обязан соответствовать файлу. ReadOnlyHint в metadata поясняет намерение, но не запрещает запись на уровне ОС. Защиту обеспечивают код и права процесса. Даже read-only server способен передать приватный текст в host, поэтому чтение имеет границу разрешения. В наборе лишь открытые учебные записи, без настоящих ключей и личных данных.

Текущая SDK-линия

Проверенная документация описывает MCP2026-07-28 и стабильный TypeScript SDK v2 с отдельными пакетами server/client. Старый @modelcontextprotocol/sdk относится к v1; не смешивайте его imports с v2. Для лаборатории используем JavaScript ESM на поддерживаемом Node и Zod4. В новом учебном каталоге фиксируйте установленные версии и package-lock. Библиотека сама не доказывает modern negotiation конкретного запуска: serveStdio factory и legacy connect ведут себя по-разному, что проверяется отдельно в следующих уроках.

npm init -y
npm pkg set type=module
npm install --save-exact @modelcontextprotocol/server @modelcontextprotocol/client zod@4
npm install --save-dev --save-exact @modelcontextprotocol/inspector

Практическое задание

Практика: Контракт read-only MCP

Перейти к обучению

Программа курса

  1. Контракт read-only MCP
  2. Каталог и схема аргументов
  3. Tool и resource в настоящем server
  4. Stdio, HTTP и version negotiation
  5. Протокольные тесты без модели
  6. Подключение клиента и приёмка