Khavion Architecture Review

Khavion Architecture Review MCP サーバー

AI アシスタントが作り出せない2つのものを提供する MCP サーバーです。クラウドプロバイダー自身によるベストプラクティスの文章を、リンク付きで一言一句そのまま引用したものと、Terraform、CloudFormation、Kubernetes のファイルをルールベースでレビューした結果です。

サーバー自体は AI モデルを呼び出しません。すべての指摘は、バージョン管理された固定のルールセットに基づいており、同じ入力には常に同じ出力が返されます。マシン上で stdio を介して実行され、実行時の依存関係はありません。

ツール

ツール	内容	キーが必要
lookup_citation	サービスに関する引用付きルールを最大5件返します（service、任意のpillar、任意のquestion）。各ルールには、一言一句そのままの引用と出典ページが含まれます。	いいえ、常に完全な結果
review_iac	Terraform、CloudFormation、Kubernetes のファイル内容（files：パスと内容）をレビューします。	任意
review_stack	サービスの一覧（tokens）を、任意のワークロードに関する説明文（intent）とともにレビューします。	任意
explain_finding	ルール ID またはレポートリンク内の8文字の ID を指定して、1件の指摘について、重要な理由、修正方法、引用を説明します。	いいえ、常に完全な結果

インストール

stdio サーバーを起動できる MCP クライアントであれば使用できます。コマンドは次のとおりです。

npx -y @khavion/architecture-review-mcp

Claude Code の場合：

claude mcp add architecture-review -- npx -y @khavion/architecture-review-mcp

Claude Desktop、Cursor、その他ほとんどのクライアントでは、次のような JSON エントリーを使用します。

{
  "mcpServers": {
    "architecture-review": {
      "command": "npx",
      "args": ["-y", "@khavion/architecture-review-mcp"]
    }
  }
}

Node 20 以降が必要です。

無料版とキーを使った出力

キーがない場合、review_iac と review_stack は重大度の高い指摘を上位3件まで、それぞれの引用とともに返し、残りの件数も示します。出力には次のように表示されます。

無料の業務用メールアドレスキーを使用すると、すべての指摘、引用の合計、推奨される次のステップ、レポートリンクが利用できます：https://khavion.com/tools/api-key

有効なキーを使用すると、すべての指摘、明細付きの引用合計、推奨される次のステップ、khavion.com のレポートへのリンクが返されます。価格に関する各行の末尾には、「見積もりであり、申し込みではありません。最終価格は、署名済みの業務委託契約書に基づきます。」と記載されます。

キーが会話に含まれないよう、サーバーの環境変数に設定してください。

{
  "mcpServers": {
    "architecture-review": {
      "command": "npx",
      "args": ["-y", "@khavion/architecture-review-mcp"],
      "env": { "KHAVION_API_KEY": "your-key" }
    }
  }
}

キーを確認できない場合（オフライン、またはキーが受け付けられない場合）、サーバーは無料版の出力に切り替え、その理由を1文で示します。

送信先と送信内容

レビューはすべてマシン上で実行されます。ファイルの内容、サービスの一覧、トークンが外部に送信されることはありません。

キーが設定されている場合、サーバーは khavion.com に対して、次の2つの呼び出しのみを行います。

1. キーを確認するため、キーを含めて POST /api/api-key/verify を呼び出します。
2. レポートリンクを取得するため、キー、指摘のルール ID、見つかったサービス数を示す数値を含めて POST /api/api-key/report を呼び出します。

KHAVION_BASE_URL を別のアドレスに設定すると、これら2つの呼び出し先を変更できます。テストに便利です。https、またはローカルアドレスの http を指定する必要があります。

引用とライセンス

サーバーのコードは MIT ライセンスです（LICENSE を参照）。

ナレッジベース内の引用は、クラウドプロバイダーの公開ドキュメントから抜粋した短い文章（25語以内）です。解説と出典表示のため、出典ページを添えて変更せずに表示しています。MIT ライセンスが適用されるのはコードであり、これらの文章には適用されません。各文章の権利はそれぞれの所有者に帰属し、lookup_citation と explain_finding の結果には、引用ごとのライセンス表示が含まれます。

概要

クラウドパートナープログラムの申請書類のレビューや GenAI プロジェクトへの助言を行う独立系企業、Khavion LLC が開発・保守しています。Khavion は Amazon Web Services、Microsoft、Google とは提携関係になく、承認や後援も受けていません。各社名は、引用の出典ドキュメントを示す目的でのみ使用しています。お問い合わせ：[email protected]。

ソース

このリポジトリには、npm で公開されている MCP サーバーが含まれています。dist/index.js は npm パッケージに含まれるファイルそのもので、Khavion のサイトコードにあるルールエンジンと検証済みの引用ナレッジベースをバンドルしているため、インストール手順は不要で、キーを設定しない限りネットワークへの呼び出しも行いません。src/ はサーバーラッパーと共有レビューコードで、閲覧用です。サイトコードからエンジンをインポートしており、このリポジトリ単体ではビルドされません。

問題は https://github.com/Khavion/architecture-review-mcp/issues に報告してください。ライセンス：コードは MIT です。引用文は出典を明記した公開ドキュメントです。