laf-mcp-template

Es el punto de partida de un servidor MCP que conecta su servicio al bot LAF. El contrato es una sola página, mcp-contract.md, y este repositorio es la implementación mínima ejecutable de ese contrato, más un verificador previo a la entrega y CI.

Con el botón Use this template cree su repositorio y, con solo completar collectSignals(), la herramienta estándar laf.watch queda lista.

Inicio

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

La verificación del servidor remoto se hace con bun laf-mcp-check.ts <url> [--token <bearer>] [--json].

Related MCP server: wrg-mcp-server

Orden para completar

1. collectSignals() — solo lo que "si se detiene, es un problema grave". No es telemetría, es la lista de guardia. La decisión de umbral (a partir de cuántos pasa a warn) debe resolverse siempre en el servidor y exportarse como status. Aunque el backend se caiga, se responde con una señal en lugar de un error de protocolo (contrato §1.2).

2. Añadir herramientas libres — por tareas que se le pidan al bot, se recomienda un máximo de 10 herramientas. Cada herramienta declara las anotaciones estándar de MCP (contrato §2). Una herramienta sin anotaciones se trata como de máximo riesgo (destructive) al registrarse, por lo que el bot prácticamente no puede usarla. No cree herramientas de escritura desde el principio; primero pruebe una semana solo con lectura y añada únicamente las que resulten necesarias: en la práctica es más rápido.

3. Pasar la verificación — hasta que bun run check dé FAIL 0. El flujo de trabajo de GitHub Actions incluido ejecuta la misma verificación en cada push.

4. Despliegue — en su propia infraestructura. La revisión de código, la gestión de secretos y la disponibilidad son responsabilidad suya; a la plataforma solo se le entregan la URL y el token Bearer.

5. Registro — al registrar la URL en la pantalla de administración de LAF, la plataforma hace polling periódico de laf.watch (sin modelo, con código puro) y solo convierte en eventos la aparición, desaparición y transición de señales. Las herramientas libres se ejecutan en la conversación del bot según su declaración de riesgo: las de lectura en silencio; las destructivas, de envío o de dinero esperan la aprobación humana.

Lo que no debe hacerse

• Diferir la decisión de umbral a la plataforma: el status se determina en el servidor.

• Convertir una falla del backend en un error de protocolo: se responde con una señal.

• Omitir anotaciones: todo se tratará como destructive.

• Reducir las anotaciones después del registro: se considera una elevación de privilegios y se activa la suspensión automática y un nuevo consentimiento.

Archivos

MIT — LICENSE.