Контракт 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
Перейти к обучению