mcp-server-hcp-terraform

基本能力

产品定位

mcp-server-hcp-terraform 是一个与 HashiCorp Terraform Cloud/Enterprise API 集成的 MCP 服务器，主要用于管理和查询 Terraform 模块。

核心功能

1. 搜索私有模块：使用 hcp_terraform_search_private_modules 工具在 HCP Terraform 私有注册表中搜索模块。
2. 参数：query（搜索查询）、provider（可选，如 aws、gcp、azure）、limit（可选，默认 10）。
3. 获取模块详情：使用 hcp_terraform_get_module 工具从 HCP Terraform 注册表中获取特定模块的详细信息。
4. 参数：module_name（模块名称）、provider（如 aws、gcp、azure）、registry_name（可选，默认为 private）、namespace（可选，默认为组织名称）。

适用场景

1. 开发效率提升：帮助开发人员快速查找和使用 Terraform 模块，提高基础设施即代码（IaC）的开发效率。
2. 团队协作：在团队中共享和管理 Terraform 模块，确保模块的一致性和可重用性。

工具列表

1. hcp_terraform_search_private_modules：用于搜索 HCP Terraform 私有注册表中的模块。
2. hcp_terraform_get_module：用于获取 HCP Terraform 注册表中特定模块的详细信息。

常见问题解答

1. 如何设置环境变量？
2. 需要设置 HCP_TERRAFORM_TOKEN（访问令牌）、HCP_TERRAFORM_ORG（组织名称）、HCP_TERRAFORM_BASE_URL（可选，默认为 https://app.terraform.io）。

使用教程

使用依赖

1. Python 3.13+：确保系统已安装 Python 3.13 或更高版本。
2. HCP Terraform Cloud/Enterprise 账户：需要一个有效的账户和访问令牌。

安装教程

1. 克隆或下载项目代码。
2. 设置环境变量： bash export HCP_TERRAFORM_TOKEN="your_access_token" export HCP_TERRAFORM_ORG="your_organization_name"
3. 运行 MCP 服务器： bash uv run --with mcp[cli] mcp run path/to/mcp-server-hcp-terraform/server.py

调试方式

1. 确保环境变量已正确设置。
2. 检查 Python 版本是否符合要求。
3. 运行 MCP 服务器并查看输出日志，确认无错误信息。

许可证

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