laf-mcp-template

Это отправная точка MCP-сервера, подключающего ваш сервис к боту LAF. Контракт — это всего лишь один документ: mcp-contract.md, а этот репозиторий — минимальная рабочая реализация этого контракта + проверка перед отправкой и CI.

Нажмите кнопку Use this template, чтобы создать репозиторий вашей компании, и заполните только collectSignals() — и стандартный инструмент laf.watch будет готов.

Начало работы

bun install
bun start          # http://127.0.0.1:8765/mcp
bun run check      # 제출 전 검사 — 등록 화면과 같은 질문을 CI에서 미리

Проверка удалённого сервера выполняется командой bun laf-mcp-check.ts <url> [--token <bearer>] [--json].

Related MCP server: wrg-mcp-server

Порядок заполнения

1. collectSignals() — только то, «что если остановится — будет беда». Это не телеметрия, а список дежурных. Пороговая оценка (с какого количества начинается warn) обязательно выполняется на сервере и выводится через status. Даже если бэкенд упал, вместо ошибки протокола отвечаем сигналом (контракт §1.2).

2. Добавление свободных инструментов — по единицам задач для бота, рекомендуется не более 10 инструментов. Для каждого инструмента объявляются стандартные аннотации MCP (контракт §2). Инструмент без аннотаций при регистрации считается максимально опасным (destructive) — бот фактически не сможет его использовать. Пишущие инструменты лучше не создавать с самого начала: сначала неделю поработать только на чтении, а затем добавить лишь то, что действительно понадобилось, — так на практике быстрее.

3. Прохождение проверки — до тех пор, пока bun run check не даст FAIL 0. Включённый рабочий процесс GitHub Actions запускает ту же проверку при каждом пуше.

4. Развёртывание — в инфраструктуре вашей компании. Код-ревью, управление секретами и доступность — ответственность вашей компании; платформе передаются только URL и Bearer-токен.

5. Регистрация — после регистрации URL в консоли управления LAF платформа периодически опрашивает laf.watch (без модели, чистым кодом) и превращает в события только появление, исчезновение и переходы сигналов. Свободные инструменты выполняются в диалоге с ботом согласно объявленному уровню риска — чтение — тихо, разрушительные, исходящие и денежные операции ждут одобрения человека.

Чего не делать

• Не перекладывать пороговую оценку на платформу — status определяется на сервере.

• Не выдавать сбой бэкенда за ошибку протокола — отвечайте сигналом.

• Не пропускать аннотации — всё будет считаться destructive.

• Не понижать аннотации после регистрации — это расценивается как повышение привилегий и влечёт автоматическую приостановку + повторное согласие.

Файлы

MIT — LICENSE.