🚀 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 文件。