Terraform Cloud MCP

🚀 Terraform Cloud MCP 服務器

Terraform Cloud MCP 服務器是基於 Model Context Protocol (MCP) 的服務，可與 Terraform Cloud 交互。它提供了豐富工具和功能，助力用戶管理和操作雲基礎設施。

🚀 快速開始

📦 安裝指南

# 克隆倉庫
git clone https://github.com/severity1/terraform-cloud-mcp.git
cd terraform-cloud-mcp

# 創建虛擬環境並激活
uv venv
source .venv/bin/activate  # 在 Windows 系統中使用：.venv\Scripts\activate

# 安裝依賴項
uv pip install .

運行服務器

# 以開發模式運行服務器
mcp dev terraform_cloud_mcp/server.py

✨ 主要特性

• 自動化運行管理：通過 MCP 協議實現對 Terraform 運行的自動化控制。
• 詳細日誌記錄：默認啟用調試日誌，便於排查問題。
• MCP 檢查器集成：內置檢查工具（訪問地址：http://localhost:5173）用於調試和監控。

📚 詳細文檔

開發指南

快速開發環境搭建

# 克隆倉庫
git clone https://github.com/severity1/terraform-cloud-mcp.git
cd terraform-cloud-mcp

# 創建虛擬環境並激活
uv venv
source .venv/bin/activate  # 在 Windows 系統中使用：.venv\Scripts\activate

# 安裝開發版本及依賴項
uv pip install -e .
uv pip install black mypy pydantic ruff

基本開發命令

# 運行服務器
mcp dev terraform_cloud_mcp/server.py

# 執行測試和代碼檢查
uv run -m mypy .
uv run -m ruff check .
uv run -m black .

文檔資源

• 代碼註釋：重點解釋實現決策背後的“原因”。
• 文檔字符串：所有公開函數和類均包含詳細說明。
• 示例文件：
  • docs/DEVELOPMENT.md：開發標準和編程指南。
  • docs/CONTRIBUTING.md：貢獻項目的指導方針。
  • docs/models/：所有模型類型的使用示例。
  • docs/tools/：每個工具的詳細用法說明。
  • docs/conversations/：與 API 交互的示例對話流程。

🔧 技術細節

故障排除

1. 檢查服務器日誌（默認啟用調試記錄）。
2. 使用 MCP 檢查器進行調試（訪問地址：http://localhost:5173）。
3. 在 server.py 中已啟用調試記錄：

   import logging
   logging.basicConfig(level=logging.DEBUG)
   

🤝 貢獻指南

歡迎貢獻！請通過提交問題或拉取請求參與項目。

詳細信息請參閱 CONTRIBUTING.md，瞭解如何開始、代碼質量標準及拉取請求流程。