Контракт 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; не змішуйте його шляхи імпорту з прикладами 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
Перейти до навчання