spec 1.0 · referencia

Servidor MCP

Traducción asistida por agentes de IA. Ante cualquier diferencia, prevalece la página en inglés. Si encuentra algún problema en el texto, abra un issue o envíe un pull request.

El utillaje de Leji se ofrece por dos vías. La CLI es para usted y para su integración continua; el servidor del Model Context Protocol (MCP) es para su agente.

@leji-org/mcp es un servidor MCP local basado en el SDK de referencia. Su agente lee la especificación y los esquemas, valida una capa de contexto en disco y puntúa su conformidad, sin descargar nada del sitio y sin invocar la CLI desde una shell.

Se ejecuta localmente mediante stdio y no realiza llamadas de red durante la ejecución, aunque la primera instalación con npx descarga el paquete. Solo expone herramientas de lectura.

Añádalo a su cliente

Configúrelo una vez y las herramientas leji aparecerán en todas las sesiones que cubra su ámbito, sin más preparativos: un registro en el ámbito de usuario abarca todos los proyectos; uno en el ámbito de proyecto, solo ese repositorio. El cliente lanza leji-mcp cuando hace falta.

Si está adoptando con la CLI y tiene Claude Code o Codex en su PATH, leji init y leji adopt ofrecen registrar este servidor para ese host, antes de dar paso a su agente.

La oferta es interactiva, así que una ejecución con --yes la omite. Lo que sigue es para quien omitió la pregunta, usa otro cliente o quiere un ámbito distinto.

Claude Code

claude mcp add leji --scope project -- npx -y @leji-org/mcp

--scope project escribe el .mcp.json compartido en la raíz del repositorio; confírmelo y a todo el que clone el repositorio se le ofrecerá el servidor. Para su usuario en todos los proyectos, en cambio:

claude mcp add leji --scope user -- npx -y @leji-org/mcp

Omitir --scope registra el servidor en privado, solo para este proyecto. Referencia completa: documentación de MCP de Claude Code.

Codex

codex mcp add leji -- npx -y @leji-org/mcp

O añada directamente una tabla [mcp_servers.leji] a ~/.codex/config.toml. Referencia completa: documentación de MCP de Codex.

Otros clientes

Claude Desktop, Cursor, Windsurf y cualquier otro cliente MCP aceptan la configuración estándar:

{
  "mcpServers": {
    "leji": { "command": "npx", "args": ["-y", "@leji-org/mcp"] }
  }
}

Requiere Node.js 22 o posterior (npx viene con Node). La primera ejecución descarga el paquete; las siguientes usan la caché. Apunte cada herramienta a la raíz del repositorio que contiene su leji.json.

Herramientas

Todas de solo lectura. Nada de lo que expone el servidor puede escribir ni cambiar su capa de contexto.

Herramientas MCP que expone el servidor
Herramienta	Qué devuelve
`search_spec`	Las secciones de la especificación que coinciden con una consulta.
`fetch_spec_doc`	Un documento de la especificación (o la especificación entera).
`fetch_schema`	Un esquema JSON.
`validate_manifest`	Validar un leji.json suministrado en línea.
`validate_layer`	Validar la capa de contexto que hay en una ruta.
`score_conformance`	Nivel de conformidad declarado frente a verificado.
`explain_conformance`	Qué está verificado y qué necesita el siguiente nivel.

Recursos

Recursos MCP que expone el servidor
URI	Qué sirve
`leji://spec/full`	La especificación completa, en un solo documento.
`leji://spec/{id}`	Un documento de la especificación, por ejemplo leji://spec/conformance.
`leji://schema/{name}`	Un esquema JSON, por ejemplo leji://schema/context-manifest.
`leji://cli/help`	La referencia de comandos y opciones de la CLI leji.

¿Por qué un servidor, y no solo la CLI?

La CLI ya valida y puntúa una capa de contexto, y el servidor ofrece ambas cosas. Además hace lo que la CLI no hace: permite buscar y consultar la especificación y los esquemas. También ofrece una interfaz distinta, a la que un agente recurre por su cuenta:

Se anuncia solo. Configurado una vez, aparece en la lista de herramientas de su agente en cada sesión, con descripciones de exactamente lo que hace. Nadie tiene que decirle al agente que Leji existe ni dónde encontrar la CLI.
Funciona donde una shell no. Muchos entornos de agente no pueden o no quieren ejecutar comandos arbitrarios. Un servidor de solo lectura que no hace llamadas de red en tiempo de ejecución es accesible allí donde leji validate no lo es.
Sirve la especificación y los esquemas directamente. Su agente los lee como recursos, sin descarga web, y los cita mientras trabaja.

Consumir una capa de contexto no necesita el servidor: el perfil de arranque de un repositorio conforme ya incorpora a su agente. El servidor es para la otra mitad: aprender Leji y comprobar una capa de contexto frente a la especificación.