GCP Terraform MCP Server

基本能力

产品定位

GCP Terraform MCP Server 旨在为开发者提供在 GCP 上使用 Terraform 的最佳实践、安全合规性和基础设施即代码的指导。

核心功能

• Terraform 最佳实践：提供 GCP 架构指导、安全合规建议和 GCP 提供者配置的最佳实践。
• 安全优先的开发流程：提供验证和安全扫描的逐步指导，集成 Checkov 进行安全扫描。
• Checkov 集成：运行安全扫描以识别漏洞，自动修复安全问题并提供详细的修复指南。
• GCP 提供者文档：搜索 Google Cloud 提供者资源，获取文档和示例代码。
• GCP GenAI 模块：访问 AI/ML 工作负载的专用模块，如 Vertex AI、BigQuery、BigTable 等。
• Terraform 注册表模块分析：分析 Terraform 注册表模块，了解模块使用和配置选项。
• Terraform 工作流执行：直接运行 Terraform 命令，如初始化、计划、验证、应用和销毁。

适用场景

• 在 GCP 上使用 Terraform 构建和管理基础设施的开发者。
• 需要安全合规性检查和自动修复的团队。
• 需要访问 GCP 提供者文档和示例代码的开发者。
• 需要运行 AI/ML 工作负载的团队。

工具列表

• Terraform Development Workflow：通过 terraform://workflow_guide 遵循安全优先的开发流程。
• GCP Best Practices：通过 terraform://gcp_best_practices 访问 GCP 特定指导。
• GCP Provider Resources：通过 terraform://gcp_provider_resources_listing 访问资源列表。

常见问题解答

• 安装问题：确保已安装 uv、Python、Terraform CLI 和 Checkov。
• 模块缺失：如果缺少 fastmcp.models 子模块，直接从 GitHub 安装最新代码。
• 运行问题：确保虚拟环境已激活且依赖项安装无误。

使用教程

使用依赖

1. 安装 uv： bash # 从 Astral 安装 uv # 或从 GitHub README 安装
2. 安装 Python： bash uv python install 3.10
3. 安装 Terraform CLI 和 Checkov。
4. 设置 GCP 认证（推荐使用 gcloud CLI）。

安装教程

安装 FastMCP

推荐使用 uv 安装和管理 FastMCP：

uv add fastmcp

或直接使用 pip 安装：

uv pip install fastmcp
# 或
pip install fastmcp

安装 FastMCP（支持模型）

从 GitHub 安装最新代码：

pip install --upgrade git+https://github.com/jlowin/fastmcp.git@main#egg=fastmcp

验证安装：

fastmcp version

调试方式

运行以下命令验证安装：

fastmcp version

启动服务器：

# 使用 stdio 传输（默认）
fastmcp run src/gcp_terraform_mcp_server/main.py:mcp

# 或作为 SSE 服务器在端口 8080 上启动
fastmcp run src/gcp_terraform_mcp_server/main.py:mcp --transport sse --host 0.0.0.0 --port 8080

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。