Openai MCP Example

🚀 Azure 容器應用 AI MCP 項目文檔

這是一個用於與 Azure 容器、GitHub 模型和 OpenAI API 交互的應用程序。它能通過 MCP 協議連接不同 AI 服務，支持多種身份驗證方法，提供完整開發環境，還包含詳細文檔和示例代碼，方便開發者集成和測試。

🚀 快速開始

運行項目

1. 克隆倉庫：

git clone https://github.com/manekinekko/azure-container-apps-ai-mcp.git
cd azure-container-apps-ai-mcp

2. 啟動 Docker 容器：

docker compose up -d --build

3. 進入 MCP 主控臺：

docker exec -it mcp-host bash

✨ 主要特性

• 通過 MCP 協議連接到不同的 AI 服務
• 支持多種身份驗證方法（包括無密鑰身份驗證）
• 提供完整的開發環境，便於集成和測試
• 包含詳細文檔和示例代碼

📦 安裝指南

環境變量配置

根據您選擇的 AI 服務提供商，設置相應的環境變量。

Azure OpenAI 配置

在 .env 文件中添加以下內容：

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

OpenAI 配置

在 .env 文件中添加以下內容：

OPENAI_API_KEY=your_openai_api_key
MODEL="gpt-4.1"

GitHub 模型配置

在 .env 文件中添加以下內容：

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

💻 使用示例

運行指南

使用 DevContainer（推薦）

使用 GitHub Codespaces 或 Visual Studio Code 的遠程容器功能可以直接啟動開發環境：

直接運行 Docker

1. 構建並啟動容器：

docker compose up -d --build

2. 進入 MCP 主控臺：

docker exec -it mcp-host bash

調試與日誌

可以通過設置 DEBUG 環境變量啟用詳細日誌輸出：

DEBUG=mcp:* npm start --prefix mcp-host

調試功能默認已開啟，您可以在控制檯查看詳細的運行信息。

📄 許可證

該項目遵循 MIT License 協議。完整的許可內容請參見 LICENSE 文件。