Khavion Architecture Review — Claude Code MCP server
The Khavion Architecture Review MCP server for Claude Code checks Terraform, CloudFormation, and Kubernetes against fixed rules. It also retrieves cited cloud guidance for infrastructure reviews.
MIT updated 2026-11-04
claude mcp add architecture-review-mcp -e KHAVION_API_KEY=<KHAVION_API_KEY> -- npx -y @khavion/architecture-review-mcpWhat Khavion Architecture Review does
The server reviews Terraform, CloudFormation, and Kubernetes files, or a list of cloud services. Its findings come from a fixed rule set, so identical inputs produce identical results. Separate tools retrieve provider documentation with citations and explain a finding by its rule ID.
Reviews run on the local machine. File contents, service lists, and tokens stay there. Without an API key, the review returns the three highest-severity findings and counts for the others. Setting KHAVION_API_KEY enables the full findings and a report link; the server then contacts Khavion to verify the key and create that link. Node 20 or newer is required.
What it helps with
- check Terraform files against architecture rules
- find issues in CloudFormation templates
- review Kubernetes files with fixed rules
- retrieve cited cloud-provider guidance
- explain a review finding by its rule ID
Example prompts for the agent
- Review these Terraform files and explain the findings.
- Find cited guidance for this cloud service.
- Review this service list and explain the finding with this rule ID.
How to install Khavion Architecture Review
Platform CLI
claude mcp add architecture-review-mcp -e KHAVION_API_KEY=<KHAVION_API_KEY> -- npx -y @khavion/architecture-review-mcpReplace <…> with your own values
Platform CLI
codex mcp add khavion-architecture-review --env KHAVION_API_KEY=<KHAVION_API_KEY> -- npx -y @khavion/architecture-review-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"khavion-architecture-review": {
"command": "npx",
"args": [
"-y",
"@khavion/architecture-review-mcp"
],
"env": {
"KHAVION_API_KEY": "<KHAVION_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"khavion-architecture-review": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@khavion/architecture-review-mcp"
],
"env": {
"KHAVION_API_KEY": "<KHAVION_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e KHAVION_API_KEY=<KHAVION_API_KEY> khavion-architecture-review npx -y @khavion/architecture-review-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Khavion Architecture Review
How do I install Khavion Architecture Review in Claude Code?
Run claude mcp add architecture-review-mcp -e KHAVION_API_KEY=<KHAVION_API_KEY> -- npx -y @khavion/architecture-review-mcp. Node 20 or newer is required.
What does Khavion Architecture Review do?
It checks Terraform, CloudFormation, and Kubernetes against fixed rules, retrieves cloud guidance with citations, and explains findings by rule ID.
What does Khavion Architecture Review need to run?
Node 20 or newer is required. KHAVION_API_KEY is optional: without it, reviews show the three highest-severity findings; with it, they include all findings and a report link.