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 文件以获取详细信息。

以上是该项目的主要内容。如需进一步了解或遇到问题，请参考相关文档或联系项目维护者。