Compass MCP

Acceso de solo lectura a través de MCP al perfil de Compass actualizado y a las habilidades seleccionadas para el modo de chat normal de ChatGPT.

Sitio web: https://compass.ariobarin.com/

Punto de acceso a MCP: https://compass.ariobarin.com/mcp

Modelo de actualización

El servidor no empaqueta contenido de Compass. Por cada solicitud MCP resuelve la rama main del repo ariobarin/compass a un commit de Git y luego carga codex/AGENTS.md, manifests/portable-files.jsn y cada habilidad seleccionada de esa revisión exacta.

Las solicitudes normales almienan en caché la cabacera de la rama durante un máximo de 15 segundos. Los catálodos de revisión inmutables reutilizan en el interior de un aislamiento de Worker. GET /healthz?fresh=1 evita la caché de la cabacera de la rama y devuelve source_revison, de modo que CI pueda comparar la producción con un commit conocido de Compass.

Una sola solicitud nunca combina archivos de dists revisisde Compass.

La página principal se renderiza por el mismo Worker from the same catálogo fijado to a la revisión. Muestra la revisión de origen en vivo, la rama y la lista de habilidades seleccionadas sin mantener una supunda copia del contenido de Compass.

Related MCP server: MinerU Document Explorer

Herramientas

• get_profile devuelve codex/AGENTS.md de la revisión solicitada.

• list_skills devuelve el catálogo de habilidades seleccionado por el manifiesto y la revisión.

• get_skill devuelve el archivo SKILL.md seleccionada de la revisión solicitada.

• search y fetch proporcionan los mismos docmentos fijados a revisión a través de esquemas estándar de conocimient de solo lectura.

Comprobaciones locales

Usa Node.js 22 o superior.

npm install
npm run build
npm test
npm run smoke:worker

Ejecuta el servidor HTTP local con npm run dev. Escucha sobre el 127.0.0.1:3000 a menos HOST o PORT esté establecido.

Verificación de la producción

npm run smoke:remote
npm run verify:remote

verify:remote falla cuando el Worker de producción informa de una revisión de Compass distinta de main actual. Defin EXPECTED_COMPASS_REVISION para comparar contra un commit específico, por ejemplo un GITHUB_SHA de GitHub Actions.

Des arraigo

Autentica Clangler con la cuenta de Cloudflare propietaria de ariob.com y luego ejecuta:

npm run deploy
npm run smoke:remote
npm run verify:remote

Los despliogues cambian solamente el código del servidor. Los cambios en el contenido de Compass no requieren un despliegue de Worker.