Skip to content

Установка ​

Пакет контракта закрытый. Он лежит в 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.12.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.12.0
tar -xzf notamedia-ai-mcp-contract-0.12.0.tgz package/contract.lock.json