Khavion Architecture Review

Name: Khavion Architecture Review
Author: khavion.com

本地服务

khavion.com云与基础设施01 周前更新

代码仓库访问官网

关于 Khavion Architecture Review

Khavion Architecture Review 是本地 MCP 服务，可依据固定规则审查 Terraform、CloudFormation 和 Kubernetes 配置。它还会返回带链接的云服务商最佳实践原文，无需 AI 模型或运行时依赖。

主要功能

01审查 Terraform、CloudFormation 和 Kubernetes
02提供带引用的云最佳实践原文
03解释发现项和建议修复方式
04基于规则的确定性结果
05在本地运行审查

适用场景

01部署前检查基础设施文件
02查询云服务的引用指南
03理解并处理审查发现项

MCP 相关

该服务通过 stdio 运行，向 MCP 客户端提供 `lookup_citation`、`review_iac`、`review_stack` 和 `explain_finding`。审查在本地完成；可选 API 密钥可解锁完整发现项和报告链接。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y @khavion/architecture-review-mcp

需要配置的环境变量

KHAVION_API_KEY密钥Optional. A free Khavion work-email API key (https://khavion.com/tools/api-key). Without it, reviews show the top 3 findings.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@khavion/architecture-review-mcp0.1.1stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
pillar	enum	否	将结果限制为一个 Well-Architected 支柱。省略此项则搜索所有支柱。security \| reliability \| cost \| performance \| operations \| sustainability
service	string	是	服务名称或 ID。示例：S3、Amazon RDS、Lambda、Key Vault、Cloud Run。
question	string	否	用一句话说明你想了解什么。仅用于根据共同关键词对匹配项排序。

详细介绍

Khavion 架构审查 MCP 服务

一个 MCP 服务，为 AI 助手提供两项它无法凭空编造的内容：云服务提供商自己的最佳实践原文（逐字引用并附上链接），以及对 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 解释一条审查结果：说明其重要性、修复方法和引用。	否，始终完整

安装

任何能够启动 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" }
    }
  }
}

如果无法验证密钥（例如处于离线状态或密钥未通过验证），服务会回退到免费版输出，并用一句话说明原因。

数据发送位置

审查完全在你的机器上运行。文件内容、服务列表和令牌绝不会发送到任何地方。

设置密钥后，服务只会向 khavion.com 发起两次调用，不会进行其他调用：

使用密钥调用 POST /api/api-key/verify 进行验证。
使用密钥、审查结果中的规则 ID，以及一个数字（发现的服务数量）调用 POST /api/api-key/report，以获取报告链接。

KHAVION_BASE_URL 可将这两次调用指向其他地址，便于测试。该地址必须使用 https，或使用指向本地地址的 http。

引用和许可

服务代码采用 MIT 许可（参见 LICENSE）。

知识库中的引文是摘自云服务提供商公开文档的简短段落（不超过 25 个单词）。这些段落会原样展示，并标明来源页面，用于评论和署名。MIT 许可适用于代码，不适用于这些段落：每段内容仍归其所有者所有，lookup_citation 和 explain_finding 的结果会显示每条引文的许可标签。

关于

由 Khavion LLC 构建和维护。Khavion 是一家独立公司，负责审查云合作伙伴计划申报材料，并为 GenAI 项目提供咨询。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 许可证；引文来自公开文档，并注明了来源。

支持 Markdown

登录后评论