Azure Openai MCP Example

🚀 Azure 容器应用 AI MCP プロジェクト

このプロジェクトは、Azure コンテナアプリケーションに関連する AI プロジェクトです。主にコンテナ化環境下でのインテリジェントサービスの開発と統合に焦点を当てています。

🚀 クイックスタート

このプロジェクトは、Azure コンテナアプリケーションに関連する AI 技術を用いた開発を行うものです。以下に、プロジェクトのインストール、設定、実行方法を説明します。

✨ 主な機能

• コンテナオーケストレーション：Kubernetes やその他のオーケストレーションツールを通じて、コンテナアプリケーションの自動化されたデプロイと拡張を実現します。
• インテリジェントサービス統合：AI モデルをコンテナアプリケーションと統合し、インテリジェントなサービス機能を提供します。
• モニタリングとログ：コンテナの実行時モニタリングとログ管理機能を統合し、保守と最適化を容易にします。

📦 インストール

環境変数の設定

プロジェクトを正常に実行するためには、.env ファイルに以下の環境変数を設定する必要があります。

Azure OpenAI のキーレス認証を使用する場合

Azure OpenAI のキーレス認証機能を使用する場合は、以下の情報を提供してください。

AZURE_OPENAI_ENDPOINT="https://<ai-foundry-openai-project>.openai.azure.com"
MODEL="gpt-4.1"

# （オプション）API キーでの認証を使用する場合は、以下の変数を設定できます。
# AZURE_OPENAI_API_KEY=your_azure_openai_api_key

また、Azure CLI を使用して Azure アカウントにログインし、対象のサブスクリプションを選択してください。

az login

OpenAI サービスを使用する場合

OpenAI の API を使用するには、以下の変数を設定してください。

OPENAI_API_KEY=your_openai_api_key
MODEL="gpt-4.1"

GitHub モデルを使用する場合

GitHub が提供するモデルを使用するには、以下の変数を設定してください。

GITHUB_TOKEN=your_github_token
MODEL="openai/gpt-4.1"

💻 使用例

基本的な使用法

DevContainer での実行（推奨）

このプロジェクトには DevContainer の設定が用意されており、コンテナ化環境でプロジェクトを実行できます。これは、すべての依存関係が正しくインストールされ、設定されることを保証するため、推奨される実行方法です。 DevContainer でプロジェクトを開いた後は、Docker のセクションの説明に従って MCP サーバーを実行してください。

Docker での実行

提供されている Docker Compose ファイルを使用して、Docker コンテナで MCP サーバーを実行できます。この方法は、テストや開発環境に適しています。手順は以下の通りです。

1. マシンに Docker と Docker Compose がインストールされていることを確認してください。ターミナルで docker compose コマンドを入力して、インストールされているかどうかを確認できます。
2. プロジェクトのルートディレクトリで、以下のコマンドを実行してコンテナをビルドし、起動します。

docker compose up -d --build

このコマンドは、HTTP と SSE の MCP サーバー、および PostgreSQL データベースコンテナをビルドし、起動します。 3. 以下のコマンドを使用して、MCP ホストのターミナルにアクセスします。

docker exec -it mcp-host bash

4. コンテナ内で、MCP ホストを実行し、LLM エージェントとやり取りします。具体的な手順は使用説明のセクションを参照してください。

Docker を使用しない場合

Docker 環境で実行しない場合は、具体的なプロジェクトのドキュメントやガイドを参照して、従来の環境でサービスをデプロイし、設定する方法を確認してください。

注意事項

⚠️ 重要提示

• キーレス認証を使用する場合は、Azure アカウントで関連機能が有効になっており、アクセスポリシーが正しく設定されていることを確認してください。
• GitHub モデルを使用する場合は、その API の使用制限と規則を遵守してください。
• 本番環境にデプロイする前に、サービスの安定性と信頼性を確保するために、全面的なテストと最適化を行ってください。

📄 ライセンス

プロジェクトの具体的な使用条件については、LICENSE ファイルを参照してください。

🤝 貢献ガイド

このプロジェクトに貢献したい場合は、CONTRIBUTING.md ファイルを参照して詳細を確認してください。

以上がこのプロジェクトの主な内容です。さらなる情報が必要な場合や問題が発生した場合は、関連するドキュメントを参照するか、プロジェクトのメンテナに連絡してください。