Безкоштовний урок

Контракт 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

Перейти до навчання

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

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