Azure Openai MCP Example

🚀 Azure 容器應用 AI MCP 項目

本項目聚焦於 Azure 容器應用的 AI 領域，致力於在容器化環境下開展智能服務的開發與集成工作，為相關應用場景提供強大的技術支持。

🚀 快速開始

本項目提供了多種運行方式，你可以根據自身需求進行選擇。

在 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 環境下運行，請參考具體的項目文檔或指南，以瞭解如何在傳統環境中部署和配置服務。

✨ 主要特性

• 容器編排：通過 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"

💻 使用示例

本項目的功能包括但不限於容器化服務的智能管理、模型集成與交互等。以下是主要的功能概述：

容器編排

通過 Kubernetes 或其他編排工具實現容器應用的自動化部署與擴展。

智能服務集成

將 AI 模型與容器應用結合，提供智能化的服務能力。

監控與日誌

集成容器運行時監控和日誌管理功能，便於維護和調優。

注意事項

⚠️ 重要提示

• 在使用無密鑰認證時，請確保您的 Azure 賬戶已啟用相關功能，並正確配置了訪問策略。
• 使用 GitHub 模型時，請遵守其 API 的使用限制和規範。
• 在生產環境中部署前，請進行全面的測試和優化，以確保服務的穩定性和可靠性。

📄 許可證

請查看項目的 LICENSE 文件以瞭解具體的使用條款和條件。

🤝 貢獻指南

如果您希望為該項目做出貢獻，請參考 CONTRIBUTING.md 文件以獲取詳細信息。

以上是該項目的主要內容。如需進一步瞭解或遇到問題，請參考相關文檔或聯繫項目維護者。