laf-mcp-template

自社サービスをLAF ボットに接続する MCP サーバーの出発点です。 契約は 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）。アノテーションのないツールは 登録時に最高リスク（破壊的）として扱われ、ボットが実質使用できません。 書き込みツールは最初から作らず、読み取りだけで 1 週間運用してみて、必要になったものだけ 追加する方が実際には速いです。

3. 検査の通過 — bun run check が FAIL 0 になるまで。同梱の GitHub Actions ワークフローがプッシュのたびに同じ検査を実行します。

4. デプロイ — 自社インフラへ。コードレビュー・シークレット管理・可用性は自社の責任であり、 プラットフォームには URL と Bearer トークンのみが渡されます。

5. 登録 — LAF 管理画面に URL を登録すると、プラットフォームが laf.watch を 定期ポーリング（モデルなし、純粋なコードで）し、シグナルの出現・消滅・遷移のみを イベント化します。自由ツールはボット対話でリスク宣言どおりに実行されます — 読み取りは静かに、破壊的・送信・課金は人間の承認を待ちます。

やってはいけないこと

• 閾値判定をプラットフォームに先送りする — status はサーバー側で確定させます。

• バックエンド障害をプロトコルエラーとして出す — シグナルで応答します。

• アノテーションの省略 — すべて破壊的として扱われます。

• 登録後のアノテーション引き下げ — 権限昇格とみなされ、自動停止＋再同意が 発生します。

ファイル

MIT — LICENSE。