Exeris AI Bridge

Name: Exeris AI Bridge
Author: exeris-systems

ローカル

github.com/exeris-systems開発ツール01 日前に更新

リポジトリ

Exeris AI Bridge について

Exeris AI Bridgeは、Exerisアプリケーション開発者向けの読み取り専用MCPサーバーです。ビルド成果物、SDKの規約、ADR、稼働中カーネルの診断情報をAIエージェントに提供し、参照データを同梱するため実行時のネットワーク接続は不要です。

主な機能

01ビルド成果物と生成プレビューの確認
02機能構成とSDKルールの確認
03ADRとアーキテクチャ文書の検索
04カーネル診断情報の取得
05MCPリソースとプロンプトの提供

活用シーン

01ビルド出力と診断の確認
02SDKアノテーションとスコープ規則の確認
03アーキテクチャ決定とテンプレートの参照
04稼働中カーネルの調査

MCP 対応

読み取り専用ツール、ドキュメントリソース、プロンプトをMCP経由で提供し、クライアントがExerisプロジェクトやカーネルの情報を照会できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "exeris-systems-ai-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@exeris/ai-bridge"
      ],
      "env": {
        "EXERIS_PROJECT_ROOT": "<EXERIS_PROJECT_ROOT>",
        "EXERIS_DOCS_ROOT": "<EXERIS_DOCS_ROOT>"
      }
    }
  }
}

起動コマンドnpx -y @exeris/ai-bridge

設定が必要な環境変数

EXERIS_PROJECT_ROOTRoot of your own project, for build-* and caps-*. Defaults to the nearest pom.xml at or above the working directory.

EXERIS_DOCS_ROOTAn exeris-docs checkout. Without one, docs-* answers from the registry snapshot bundled in the package.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@exeris/ai-bridge0.8.0stdio

ツール

掲載時のツール一覧 · 1 週間前に更新

パラメーター	型	必須	説明
status	string	いいえ	status.state がこの値と等しいエントリーに絞り込みます（大文字と小文字を区別せず、比較前に前後の空白を除去します）。

詳細

@exeris/ai-bridge

Exeris アプリケーションのコンテキストを AI エージェントに提供する Model Context Protocol サーバーです。ビルドで出力されたもの、SDK の記述規約、ADR レジストリ、実行中のカーネルに関する情報を提供します。

すべてのツールは読み取り専用です。このブリッジはプロジェクトに書き込まず、モデル API を呼び出さず、Java カーネルとは別のプロセスとして実行されます。Exeris でアプリケーションを開発する開発者向けに作られており、エコシステムのチェックアウトがなくても動作します。必要な参照データはパッケージに同梱されています。

インストール

pom.xml が見つかるように、プロジェクト内でサーバーを実行してください。

Claude Code

claude mcp add exeris -- npx -y @exeris/ai-bridge

Claude Desktop：GitHub Releases から exeris-ai-bridge-<version>.mcpb をインストールしてください。Desktop はプロジェクト内でサーバーを起動しないため、build-* および caps-* ツールを使うには、拡張機能の設定で Project root を設定してください。

その他の MCP クライアント（Cursor、VS Code、Copilot）：コマンドは、stdio 経由の npx -y @exeris/ai-bridge です。

{
  "mcpServers": {
    "exeris": { "command": "npx", "args": ["-y", "@exeris/ai-bridge"] }
  }
}

このサーバーは io.github.exeris-systems/ai-bridge として MCP Registry にも掲載されています。

要件

Node 20 以降。
kernel-* のみ：JDK 25 以降、およびローカルの Maven リポジトリに eu.exeris:exeris-kernel-diagnostics-cli が必要です。これは Exeris アプリケーションのビルドによって配置されます。
build-preview_generation のみ：java の場合は JDK 25 以降、およびプロジェクトで固定されているツーリングのバージョンの eu.exeris:exeris-codegen-cli がローカルの Maven リポジトリに必要です。ts の場合は、プロジェクト自身の node_modules に @exeris/codegen-ts が必要です。
実行時のネットワーク接続は不要です。ブリッジはすでに ~/.m2 にある成果物を読み取り、ダウンロードは行いません。

ツール

ツール名は family-tool 形式です。全 33 個が各セッションで一覧表示されます。依存関係が不足しているファミリーは、不足の理由と解決方法を示す構造化された family_unavailable の結果を返します。

ファミリー	回答内容	ツール
`build-*`	直近のビルドで出力されたもの、コード生成が所有するファイル、ビルド診断の意味、新規アプリケーション用のビルドファイル、ジェネレーターが現時点で書き込む内容を確認できます。`toolingSkew` では、プロジェクトで固定されているツーリングのリリースが、同梱のジェネレータカタログと異なるかどうかを示します	`build-list_domains`、`build-get_domain_metadata`、`build-explain_artefacts`、`build-get_detach_state`、`build-explain_diagnostic`、`build-get_starter`、`build-preview_generation`
`caps-*`	ビルドで検証されたケイパビリティの構成	`caps-list_capabilities`、`caps-describe_composition`
`sdk-*`	SDK のアノテーション、非推奨項目、スコープ規則、AST スキーマ、およびプロジェクトで異なる SDK が固定されているかどうか	`sdk-list_annotations`、`sdk-describe_annotation`、`sdk-list_deprecations`、`sdk-get_scoping_rules`、`sdk-get_ast_schema`
`docs-*`	Exeris の ADR、高レベルアーキテクチャ、ホワイトペーパー、意思決定テンプレート	`docs-list_adrs`、`docs-get_adr`、`docs-search`、`docs-get_hla`、`docs-get_whitepaper`、`docs-get_template`、`docs-list_repos`、`docs-list_repo_docs`、`docs-get_repo_doc`
`kernel-*`	実行中のカーネルのプロバイダー、ブートストラップ DAG、サブシステム、JVM のチューニング	`kernel-list_providers`、`kernel-get_bootstrap_dag`、`kernel-describe_subsystem`、`kernel-get_jvm_ergonomics`
`lsp-*`	Studio 言語サーバーの `@ExerisDomain` 型とアクション、およびソース編集の差分プレビュー	`lsp-list_domains`、`lsp-describe_domain`、`lsp-list_actions`、`lsp-preview_mutation`
`bridge-*`	サーバー自体のバージョン、同梱データ、ファミリーが利用できない理由	`bridge-version`、`bridge-health`

docs-list_repos、docs-list_repo_docs、docs-get_repo_doc には Exeris リポジトリのチェックアウトが必要です。その他の docs-* ツールは、チェックアウトがあればそこから回答し、なければパッケージに同梱されたレジストリのスナップショットから回答します。 lsp-* にはローカルでビルドした exeris-platform-lsp が必要です。現時点では実行可能な jar は公開されていません。

リソース

docs-* のレジストリ階層は MCP リソースとしても利用でき、すべて text/markdown 形式で、すべてのセッションに表示されます。読み取り時には、ツールと同じチェックアウトまたはスナップショットの解決処理と公開範囲ポリシーが適用されます。

URI	内容
`exeris://docs/adr-index`	ADR レジストリのインデックス
`exeris://docs/adr/{NNN}`	3 桁の番号で指定した ADR。公開配信されていないリポジトリのレコードには、所有するリポジトリと GitHub URL が記載されます
`exeris://docs/hla`	ハイレベルアーキテクチャ
`exeris://docs/whitepaper`	B2B 技術ホワイトペーパー
`exeris://docs/template/{ADR\|RFC\|RESEARCH}`	意思決定ドキュメントのテンプレート

exeris://docs/adr-index は購読できます（resources/subscribe）。exeris-docs のチェックアウトからは、ファイルへの変更がまとまるたびに、名前の変更による置き換えも含め、サーバーが notifications/resources/updated を送信します。バンドルされたスナップショットはコンテンツを変更できないため、購読は受け付けられますが、通知は一度も送信されません。ほかの URI はすべて、不正なパラメーターとして拒否されます。

この一覧にない URI、または 3 桁ではない ADR 番号は、不正なパラメーターとして拒否されます。レジストリにない ADR、または配信可能なコンテンツがない ADR には、MCP のリソース未検出エラー（-32002）が返されます。ドキュメントを利用できない場合は、データに family_unavailable の理由と対処方法を含む内部エラーが返されます。

プロンプト

状態を持たない 8 つのプロンプトテンプレートが、すべてのトランスポートで各セッションに表示されます。プロンプトは、テンプレートと指定された引数から構成されたメッセージを返します。ブリッジは状態を保持せず、ループを実行せず、モデルやツールも呼び出しません。あるステップでツールが必要な場合、プロンプトはエージェントにそのツールを呼び出すよう指示します。コンテキストはリソースメッセージ（exeris://docs/* リソース）またはバンドルされた SDK データとして埋め込まれます。埋め込めない場合は、代わりに読み取るリソースがプロンプトに示されます。引数は文字列で、最大 256 文字です。ただし、diff は 65,536 文字、output は 64,000 文字、area は 64 文字で、小文字、数字、ハイフンのみを使用できます。

プロンプト	引数	事前読み込み	ローカルサーバーが必要
`review-three-tier-violations`	`diff?`	HLA、ADR-006、ADR-024、ドリフトパターンポリシー、cap-tier Wall ルール	いいえ
`draft-adr`	`title?`	ADR テンプレート、レジストリインデックス	いいえ
`route-this-task`	`task`	エコシステムのルーティングルール。ただし、エコシステムのチェックアウトからの場合のみ	いいえ
`wall-audit`	`target?`	ADR-006	いいえ
`author-domain`	`entity`、`area?`	SDK のスコープ設定ルール、AST スキーマ	`lsp-` および `build-` のステップ
`explain-my-build`	なし	なし。`build-explain_artefacts`、`build-get_detach_state` を呼び出します	はい
`diagnose-build-failure`	`output`	SDK の非推奨リスト	`build-explain_diagnostic` のステップ
`migrate-sdk-version`	`targetVersion?`	SDK の非推奨リスト	いいえ

エコシステムのチェックアウトなしで route-this-task を実行すると、ルーティングにはチェックアウトが必要であることと、その対処方法が返されます。不明なプロンプト、不明な引数、必須引数の欠落、または上限を超える引数は、不正なパラメーターとして拒否されます。

設定

アプリケーション側で設定する必要はありません。すべての変数は任意で、サーバーの起動を妨げるものはありません。

変数	デフォルト値	用途
`EXERIS_PROJECT_ROOT`	作業ディレクトリより上にある最も近い `pom.xml`	`build-`、`caps-`、`sdk-*` がレポートするプロジェクト
`EXERIS_MAVEN_REPO`	`~/.m2/settings.xml` の `<localRepository>`。指定がなければ `~/.m2/repository`	公開済みの JAR を検索する場所
`EXERIS_KERNEL_VERSION`	ローカルリポジトリにある最新リリース	起動する診断 CLI のバージョン
`EXERIS_KERNEL_COMMAND` / `EXERIS_KERNEL_JAR`	ローカルリポジトリから解決	カーネル診断 CLI を明示的に起動
`EXERIS_LSP_COMMAND` / `EXERIS_LSP_JAR`	なし	`exeris-platform-lsp` を起動
`EXERIS_LSP_WORKSPACE`	作業ディレクトリ	言語サーバーがインデックスを作成するワークスペース
`EXERIS_DOCS_ROOT`	存在する場合は兄弟ディレクトリにある `exeris-docs` のチェックアウト。それ以外は同梱スナップショット	読み込む `exeris-docs` のチェックアウト
`EXERIS_BRIDGE_MODE`	`app`	Exeris 自体の作業には `contributor` を指定します。公開済み JAR よりソースのチェックアウトが優先されます

各変数の解決方法、Java 子プロセスの起動手順、同梱のリファレンスデータについては、設定リファレンスを参照してください。

トラブルシューティング

bridge-health を呼び出してください。各ファミリーの状態と、利用できない場合はその理由および解決方法を報告します。子プロセスは起動しません。bridge-version は、ビルド情報と、同梱データの取得元となった上流リリースを報告します。また、サーバーは1行の概要（mode=… docs=… lsp=… kernel=… build=… caps=… sdk=…）を stderr に出力し、MCP クライアントはこれをログに表示します。

バージョン管理

このパッケージはセマンティックバージョニングに従います。1.0 より前は、マイナーリリースでツールの出力形式が変更される場合があります。クライアントが気づく可能性のある変更はすべて、リリースノートに記載されます。1.0 では、ツール名と入力スキーマが固定されます。

0.8.0 は、Maven Central で公開されている exeris-kernel 0.12.0、exeris-sdk 0.12.0、exeris-tooling 0.10.0 を対象としています。

リンク

ライセンス

Apache-2.0

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

Exeris AI Bridge

Exeris AI Bridge について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

@exeris/ai-bridge

インストール

要件

ツール

リソース

プロンプト

設定

トラブルシューティング

バージョン管理

リンク

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？