Azure Terminal Copilot

🚀 Azure ターミナル Copilot

Python ベースの Azure CLI アシスタントで、Azure MCP サーバーを利用して Azure コマンドに自然言語処理機能を提供します。

🚀 クイックスタート

この Azure ターミナル Copilot は、Python をベースにした Azure CLI のアシスタントです。Azure MCP サーバーを活用し、自然言語で Azure コマンドを操作できるようになっています。

✨ 主な機能

• Python ベースで、Azure CLI の操作を自然言語で行える。
• Azure MCP サーバーを利用して、高度な自然言語処理を実現。

📦 インストール

前提条件

• Python 3.11+（pyproject.toml で指定）
• Azure CLI をインストールし、設定済み
• Ollama をインストールし、モデルをダウンロード済み
• uv を Python パッケージ管理に使用
• Azure MCP サーバーをインストールし、起動済み

インストール手順

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/azure-terminal-copilot.git
   cd azure-terminal-copilot
   

2. ターミナルを開き、uv 環境を起動します。

   uv venv
   

3. uv を使ってパッケージをインストールします。

   uv pip install .
   

4. Ollama を起動し、そのローカルアドレスをメモします。
5. Azure MCP サーバーを起動し、そのローカルアドレスをメモします。
6. .env-sample ファイルを .env にリネームします。
7. サンプル値が記載されていますので、ローカルの Ollama、Azure MCP および使用するモデルに合わせて値を更新してください。
8. これで python main.py を実行できます。

📚 ドキュメント

学習

プログラムを起動したら、以下のことを試してみてください。

1. 「すべてのリソースグループをリストアップ」などのクエリを入力し、予想されるコマンドが実行されるか確認しましょう。
2. 異なるモデルを試して、どのモデルがより良い性能を発揮するかに注意を払いましょう。
3. システムプロンプトを調整して、どのように改善できるか考えてみましょう。

トラブルシューティング

• Azure MCP は Azure CLI のログイン情報を使用して認証を行うため、Azure CLI がログインしていることを確認してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については、LICENSE ファイルを参照してください。