spec 1.0 · リファレンス

MCP サーバー

AI エージェントの支援による翻訳です。内容に相違がある場合は、英語版ページが優先されます。文章に問題を見つけた際は、Issueまたはプルリクエストをお願いします。

Leji のツールには 2 つの形があります。CLI は利用者と CI 向け、Model Context Protocol（MCP）サーバーはエージェント向けです。

@leji-org/mcp は、リファレンスの SDK をラップする、ローカルの MCP サーバーです。エージェントは、サイトから取得したり 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 ツール
ツール	返すもの
`search_spec`	クエリに一致する仕様セクションを返します。
`fetch_spec_doc`	仕様文書を 1 つ、または仕様全文を返します。
`fetch_schema`	JSON Schema を 1 つ返します。
`validate_manifest`	インラインで渡された leji.json を検証します。
`validate_layer`	指定したパスのコンテキストレイヤーを検証します。
`score_conformance`	宣言された適合レベルと、検証された適合レベルを返します。
`explain_conformance`	検証済みの項目と、次のレベルに必要な項目を返します。

サーバーが公開する MCP リソース
URI	提供するもの
`leji://spec/full`	仕様全文を 1 つの文書として返します。
`leji://spec/{id}`	仕様文書を 1 つ返します。例：leji://spec/conformance。
`leji://schema/{name}`	JSON Schema を 1 つ返します。例：leji://schema/context-manifest。
`leji://cli/help`	leji CLI のコマンドとオプションのリファレンス。

CLI はすでにコンテキストレイヤーの検証と適合性の判定に対応しています。サーバーもこの 2 つを提供します。さらに、CLI にはない仕様とスキーマの検索、提供にも対応し、エージェントが自ら利用できる別のサーフェスになります。

自動的に認識されます。一度設定すれば、セッションのたびにエージェントのツール一覧へ、機能の説明付きで表示されます。Leji の存在や CLI の場所を、誰かがエージェントに教える必要はありません。
シェルが使えない場所でも動きます。多くのエージェント環境では、任意のコマンドを実行できないか、方針として実行させません。実行時にネットワークへ接続しない読み取り専用サーバーなら、leji validate を実行できない環境でも利用できます。
仕様とスキーマを直接提供します。エージェントはウェブから取得せずに、これらをリソースとして読み、作業中に引用できます。

コンテキストレイヤーを利用するだけなら、サーバーは不要です。適合したリポジトリのブートプロファイルが、すでにエージェントを案内します。サーバーが担うのはもう一方、つまり Leji を理解し、コンテキストレイヤーを仕様に照らして検証する役割です。