Тема
Установка
Пакет контракта закрытый. Он лежит в GitHub Packages под именем @notamedia-ai/mcp-contract, а не на npmjs.com, и скачивается только с токеном. Доступ к пакету и токен на чтение пакетов (право read:packages) выдаёт команда NORM — запросите их.
Добавьте в файл .npmrc в корне проекта две строки. Первая говорит npm, где искать пакеты с префиксом @notamedia-ai, вторая — каким токеном входить в этот реестр.
ini
@notamedia-ai:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${NPM_TOKEN}Файла .npmrc нет — создайте его. Сам токен в файл не пишите: npm подставит его из переменной окружения NPM_TOKEN. Задайте её там, где ставите пакет: на своей машине и секретом в CI.
Затем установите пакет:
bash
npm install @digital-shift/mcp-contract@npm:@notamedia-ai/mcp-contract@0.13.0Запись @digital-shift/mcp-contract@npm:… — псевдоним npm: пакет встанет под именем @digital-shift/mcp-contract, и пути импорта ниже работают как есть. pnpm и yarn ставят пакет той же записью (pnpm add, yarn add).
pnpm и yarn 1 читают тот же .npmrc. Yarn 2 и новее его не читает: ему нужен файл .yarnrc.yml.
yaml
npmScopes:
notamedia-ai:
npmRegistryServer: "https://npm.pkg.github.com"
npmAuthToken: "${NPM_TOKEN}"Что даёт пакет:
| Путь импорта | Что внутри |
|---|---|
@digital-shift/mcp-contract | слепок contractLock, ключи META_KEYS, таблица сторон ERROR_SIDES, пределы LIMITS |
@digital-shift/mcp-contract/check | проверка ответа validateResult, проверка списка инструментов validateToolList, план перевода версий planTranslation |
@digital-shift/mcp-contract/contract.lock.json | сам слепок: для серверов не на TypeScript его достаточно |
В установленном пакете есть и команда npx norm-contract: catalog перечисляет инструменты каталога, lock print выводит слепок. Проверка живого сервера (check) пока не реализована.
Серверу не на TypeScript ставить пакет в проект не нужно. Слепок можно достать из архива пакета — с тем же .npmrc и токеном:
bash
npm pack @notamedia-ai/mcp-contract@0.13.0
tar -xzf notamedia-ai-mcp-contract-0.13.0.tgz package/contract.lock.json