spec 1.0 · 参考

MCP 服务器

AI 智能体辅助翻译。如有出入，以英文页面为准。如果你发现文本有任何问题，欢迎提交议题或发起拉取请求。

Leji 的工具有两种形态。CLI 面向你和你的 CI；Model Context Protocol（MCP）服务器面向你的智能体。

@leji-org/mcp 是一个本地的 MCP 服务器，封装了参考 SDK。智能体可以用它读取规范与 schema、校验磁盘上的上下文层并评估其一致性，无需抓取网站，也不必通过 shell 调用 CLI。

它在本地通过 stdio 运行，运行期不发起任何网络调用（不过首次 npx 安装会拉取该包），并且只暴露只读工具。

把它加到你的客户端

配置一次，leji系列工具就会出现在其作用域覆盖的每一次会话中，无需再做任何设置：用户级注册覆盖每个项目，项目级注册覆盖那个仓库。客户端会按需启动 leji-mcp。

如果你正用 CLI 接入，而 Claude Code 或 Codex 就在你的 PATH 上，那么 leji init 与 leji adopt 会在交接给你的智能体之前，主动提议为那个宿主注册这个服务器。

由于这项提议需要交互确认，使用 --yes 运行时会跳过。以下说明适用于跳过提示、使用其他客户端，或希望采用不同作用域的情况。

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

--scope project 会在仓库根目录写入共享的 .mcp.json；把它提交上去，之后每个克隆该仓库的人都会收到启用这个服务器的提议。若想改为对你个人、覆盖所有项目：

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

省略 --scope 会以私有方式注册该服务器，仅限本项目。完整参考： Claude Code MCP 文档。

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

或者直接在 ~/.codex/config.toml 中添加一个 [mcp_servers.leji] 表。完整参考： Codex MCP 文档。

Claude Desktop、Cursor、Windsurf，以及任何其他 MCP 客户端，都用这份标准配置：

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

需要 Node.js 22 或更新版本（npx 随 Node 一起提供）。首次运行会拉取该包；之后的运行走缓存。把每个工具指向存放你的 leji.json 的那个仓库根目录。

所有工具均为只读；这个服务器暴露的能力都无法写入或修改上下文层。

该服务器暴露的 MCP 资源
URI	提供什么
`leji://spec/full`	完整规范，汇为一份文档。
`leji://spec/{id}`	单份规范文档，例如 leji://spec/conformance。
`leji://schema/{name}`	单个 JSON Schema，例如 leji://schema/context-manifest。
`leji://cli/help`	leji CLI 的命令与选项参考。

CLI 已经能够校验上下文层并评估一致性，这个服务器同样提供这两项能力。除此之外，它还能检索并提供规范与各份 schema，这是 CLI 不具备的能力；而且它是另一个入口，智能体可以自行取用的那一个：

它会自我通告。配置一次之后，它每次会话都出现在你的智能体的工具列表里，并附有它究竟做什么的说明。没有人需要去告诉智能体 Leji 的存在，也无需告诉它 CLI 在哪里。
它在没有 shell 的地方也能用。许多智能体环境不能、也不愿运行任意命令。一个只读、运行期不发起网络调用的服务器，在leji validate 够不到的地方也够得到。
它直接提供规范与 schema。你的智能体把它们当作资源读取，无需网页抓取，并在工作中引用它们。

消费一个上下文层并不需要这个服务器：一个符合规范的仓库，它的引导配置本身就能引导智能体开始工作。这个服务器解决的是另一类需求：了解 Leji，并据此检查上下文层。