Terraform Cloud MCP

🚀 Terraform Cloud MCP サーバー

Terraform Cloud MCP サーバーは、Model Context Protocol (MCP) をベースにしたサービスで、Terraform Cloud とのやり取りを行うためのものです。このサーバーは、ユーザーがクラウドインフラストラクチャを管理および操作するのを支援するための豊富なツールと機能を提供します。

✨ 主な機能

• 自動実行管理：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 .

サーバーの起動

# 開発モードでサーバーを起動する
mcp dev terraform_cloud_mcp/server.py

📚 ドキュメント

開発環境の迅速なセットアップ

# リポジトリをクローンする
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 を参照してください。ここでは、開始方法、コード品質標準、およびプルリクエストの流れについて説明されています。