cloudinfra

cloudinfra

MCP ツールとして利用できる AWS のインフラストラクチャ・アズ・コードのガイダンスです。Terraform Registry のドキュメントやモジュールを検索し、Terraform の plan ファイルをローカルでポリシースキャンし、一般的な AWS リソースタイプを平易な言葉で説明します。cloudinfra は aws-terraform MCP server の主要な機能を、新しい名前でクリーンルーム方式で再構築したものです。コードと文章は新たに作成されており、ブランドをコピーしていません。

ツール（コアサブセット、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）、プロバイダースキーマの生成、料金とコストの見積もり、LLM を活用したコードやモジュールの生成、状態の操作、およびあらゆる書き込みやデプロイ操作。

仕組み

ドキュメントツールとモジュールツールは、注入可能な fetch 関数を通じて、公開 Terraform Registry API（https://registry.terraform.io/v1。ベース URL は TERRAFORM_REGISTRY_URL で上書き可能）に対して GET リクエストを行います。どのツールにも認証情報は必要ありません。

run_policy_scan は完全にローカルで動作し、決定的な結果を返します。Terraform の plan JSON（terraform show -json の出力）を渡すと、planned_values（子モジュールを含む）を走査し、4 種類のルールをチェックします（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

各ツール名はサブコマンドで、引数として 1 つの 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