mcpField
C
cloudinfra

cloudinfra

本地服务
github.com/CloudCorpRecords云与基础设施02 周前更新
代码仓库

关于 cloudinfra

cloudinfra 是面向 AWS 基础设施从业者的 MCP 服务，提供 Terraform Registry 文档与模块查询、计划文件策略扫描及资源类型说明。策略扫描在本地确定性运行，不执行 Terraform 操作或部署。

主要功能

  1. 01查询 Terraform Provider 文档与版本
  2. 02搜索模块并查看详情
  3. 03扫描 Terraform 计划策略
  4. 04解释常见 AWS 资源类型

适用场景

  1. 01查找 Provider 文档和模块
  2. 02检查计划中的公开 S3 与开放安全组
  3. 03识别未加密存储和通配 IAM 规则

MCP 相关

以 stdio MCP 服务形式提供 10 个工具，供 MCP 客户端查询 Terraform Registry、扫描计划文件并获取 AWS 资源说明。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-cloudinfra": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/cloudinfra"
      ]
    }
  }
}
启动命令npx -y @reneturcios/cloudinfra

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

安装包
npm@reneturcios/cloudinfra0.1.0
ocighcr.io/cloudcorprecords/cloudinfra:0.1.0

工具

10

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

参数类型必填说明
querystring是用于匹配 Terraform 提供程序文档主题的搜索文本。
providerstring否可选的提供程序名称，用于将文档搜索限制为单个提供程序。

详细介绍

cloudinfra

将 AWS 基础设施即代码指南封装为 MCP 工具：Terraform Registry 文档和模块查询、针对 terraform plan 文件的本地策略扫描，以及对常见 AWS 资源类型的通俗解释。cloudinfra 是对 aws-terraform MCP 服务核心功能的洁净室重建，并采用了新名称：全新的代码和文案，不复制品牌内容。

工具（核心子集，共 10 个）

search_provider_docs、get_provider_doc_details、 search_cc_provider_docs、list_provider_resources、search_modules、 get_module_details、get_latest_provider_version、 search_user_guide、run_policy_scan、explain_resource。

此子集中不包含：Terraform/Tofu CLI 执行（init/plan/apply）、 provider 架构生成、定价和成本估算、LLM 辅助的代码或模块生成、 状态操作，以及任何写入或部署操作。

工作原理

文档和模块工具通过可注入的 fetch 函数，向公开的 Terraform Registry API（https://registry.terraform.io/v1，可通过 TERRAFORM_REGISTRY_URL 覆盖基础 URL）发起经过封装的 GET 请求。所有工具均无需凭据。

run_policy_scan 完全在本地运行，且具有确定性。传入 terraform plan JSON（terraform show -json 的输出）后，它会遍历 planned_values（包括子模块；也会回退使用 resource_changes），检查以下四类规则：

  • public-s3 — ACL 公开的 S3 存储桶
  • unencrypted-storage — 未启用加密的 RDS/EBS；未配置服务器端加密的 S3 存储桶
  • wildcard-iam — 授予通配符操作或资源权限的 IAM 策略
  • open-security-group — 入站流量对 0.0.0.0/0 或 ::/0 开放

可以通过库 API 将外部扫描器作为扫描执行器注入；本项目未附带任何外部扫描器。本地检查器是默认选项，也是唯一已实现的扫描器。

explain_resource 根据本次重建编写的常见 AWS 资源类型精选目录提供解答，并会明确说明目录中未收录的类型。

CLI

npx @reneturcios/cloudinfra explain_resource '{"resource_type":"aws_s3_bucket"}'
npx @reneturcios/cloudinfra run_policy_scan '{"plan":{...}}'
npx @reneturcios/cloudinfra mcp        # stdio MCP server

每个工具名称都是一个子命令，接受一个 JSON 对象参数。

MCP 客户端配置

{
  "mcpServers": {
    "cloudinfra": {
      "command": "npx",
      "args": ["-y", "@reneturcios/cloudinfra", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/cloudinfra

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。