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

环境变量配置

根据您选择的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文件。