ai-os-orchestrator (MCP)

Servidor MCP de solo lectura sobre el universo (_shared/, worlds/<mundo>/). Expone mundos, decisiones, tareas, skills, comandos y agentes como tools consultables desde cualquier sesión de Claude Code — sin explorar el filesystem a mano ni repetir contexto entre sesiones.

Node.js + @modelcontextprotocol/sdk, transporte stdio (src/index.js, un único archivo).

Instalación (una sola vez en la máquina)

cd mcp-orchestrator
npm install

Registro

Es un servidor de universo, no de mundo — se registra a nivel usuario/global (no en el .mcp.json de un mundo concreto, que es donde van los MCP propios de stack como Supabase):

claude mcp add ai-os-orchestrator --scope user -- node "D:/ruta/ai-os/mcp-orchestrator/src/index.js"

Las tools ya vienen pre-aprobadas en _shared/templates/world.settings.json (heredado por cada mundo nuevo) y en .claude/settings.json del propio orquestador.

Tools

Solo lectura, sin escritura ni ejecución de comandos.

Tool	Qué hace
`list_worlds`	Lista los mundos con stack y estado (desde `_shared/memory/registry.json`)
`get_world_context`	Devuelve el `CLAUDE.md` de un mundo (`{ name }`)
`get_cowork_brief`	Devuelve el `COWORK.md` de un mundo (`{ name }`)
`search_decisions`	Busca ADRs en `_shared/memory/decisions.md` por palabra clave (`{ query }`)
`get_world_tasks`	Devuelve backlog/doing/review del `TASKS.md` de un mundo, omite done (`{ name }`)
`search_skills`	Busca skills en `_shared/skills` por nombre o descripción (`{ query }`)
`search_commands`	Busca comandos en `_shared/commands` por nombre o descripción (`{ query }`)
`search_agents`	Busca agentes en `_shared/agents` por nombre o descripción (`{ query }`)

Notas de implementación

ROOT se calcula relativo a src/index.js (dos niveles arriba) — no depende del cwd desde el que se lance el proceso.
search_skills/search_commands/search_agents recorren el directorio con walk() y filtran por nombre de archivo (SKILL.md o *.md), leyendo name/description del frontmatter YAML de cada archivo.
Resultados de búsqueda limitados a MAX_RESULTS = 15, descripciones truncadas a DESC_MAX_LEN = 220 caracteres — evita respuestas gigantes en universos con muchos skills/comandos.