laf-mcp-template

Dies ist der Ausgangspunkt für einen MCP-Server, der Ihren eigenen Dienst mit dem LAF-Bot verbindet. Der Vertrag besteht aus einer einzigen Seite, mcp-contract.md, und dieses Repository ist die ausführbare Mindestimplementierung dieses Vertrags plus Prüfprogramm vor der Einreichung und CI.

Erstellen Sie mit der Schaltfläche Use this template ein eigenes Repository und füllen Sie nur collectSignals() aus – schon ist das Standard-Tool laf.watch fertig.

Erste Schritte

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

Die Prüfung des Remote-Servers erfolgt mit bun laf-mcp-check.ts <url> [--token <bearer>] [--json].

Related MCP server: wrg-mcp-server

Reihenfolge beim Ausfüllen

1. collectSignals() – nur die Dinge, bei denen „ein Stopp ein großes Problem wäre". Keine Telemetrie, sondern eine Bereitschaftsliste. Die Schwellenwert-Entscheidung (ab wie vielen warn gilt) muss unbedingt serverseitig abgeschlossen und als status ausgegeben werden. Selbst wenn das Backend ausfällt, wird statt eines Protokollfehlers mit einem Signal geantwortet (Vertrag §1.2).

2. Freie Tools hinzufügen – in Einheiten dessen, was der Bot erledigen soll, empfohlen maximal 10 Tools. Für jedes Tool werden die MCP-Standardannotationen deklariert (Vertrag §2). Tools ohne Annotationen werden bei der Registrierung als höchstes Risiko (destruktiv) behandelt und können vom Bot praktisch nicht verwendet werden. Schreib-Tools sollte man von Anfang an gar nicht erst erstellen; es ist tatsächlich schneller, eine Woche lang nur mit Lesezugriff zu arbeiten und dann nur die hinzuzufügen, die sich als nötig erweisen.

3. Prüfung bestehen – bis bun run check FAIL 0 ergibt. Der enthaltene GitHub Actions-Workflow führt bei jedem Push dieselbe Prüfung aus.

4. Bereitstellung – in der eigenen Infrastruktur. Code-Review, Geheimnisverwaltung und Verfügbarkeit liegen in der eigenen Verantwortung; an die Plattform werden nur URL und Bearer-Token übergeben.

5. Registrierung – Wenn die URL im LAF-Verwaltungsbildschirm registriert wird, pollt die Plattform laf.watch periodisch (ohne Modell, in reinem Code) und erzeugt nur aus dem Erscheinen, Verschwinden und Übergang von Signalen Ereignisse. Freie Tools werden in Bot-Gesprächen gemäß ihrer Risikodeklaration ausgeführt – Lesen still, destruktive, ausgehende und kostenpflichtige Aktionen warten auf menschliche Genehmigung.

Was man nicht tun sollte

• Die Schwellenwert-Entscheidung auf die Plattform verschieben – status wird serverseitig festgelegt.

• Backend-Ausfälle als Protokollfehler melden – mit Signalen antworten.

• Annotationen weglassen – alles wird als destruktiv behandelt.

• Annotationen nach der Registrierung herabstufen – dies gilt als Rechteausweitung und führt zu automatischer Sperrung plus erneuter Zustimmung.

Dateien

MIT – LICENSE.