Шаблоны MCP-серверов

Готовые к использованию шаблоны MCP-серверов промышленного уровня с границами разрешений, интеграционными тестами и контрактами оценки.

Шаблоны

Шаблон	Описание	Ключевые особенности
basic	Минимальный MCP-сервер	Инструменты эхо-запроса и вычислений, валидация Zod
database	Доступ к базе данных только для чтения	SQL-валидация, интроспекция схемы, границы разрешений
api-gateway	Прокси внешнего API	Ограничение частоты запросов, область действия учетных данных, конфигурация конечных точек

Быстрый старт

Клонируйте этот репозиторий или используйте кнопку "Use this template" на GitHub
Перейдите в нужный шаблон: cd templates/basic
Установите зависимости: pnpm install
Запустите сервер: pnpm start

Архитектура

Каждый шаблон следует одним и тем же паттернам:

Механизм разрешений — Декларативные правила (разрешить/запретить), проверяемые перед каждым вызовом инструмента
Тестовый клиент в памяти — Интеграционные тесты через InMemoryTransport из MCP SDK
Контракты оценки — Спецификации оценки в формате YAML, совместимые с @visystems/claude-eval-runner

Общие утилиты

Директория shared/ содержит переиспользуемые утилиты:

permissions/ — Типы политик разрешений, механизм и PermissionDeniedError
testing/ — Тестовый MCP-клиент в памяти для интеграционных тестов
errors/ — Типизированные классы ошибок

Разработка

pnpm install
pnpm typecheck    # TypeScript type checking
pnpm test         # Run all tests
pnpm test:shared  # Run shared utility tests only
pnpm test:basic   # Run basic template tests only