Azure OpenAI集成工具

一个基于FastAPI的应用程序,将Azure OpenAI与MCP(模型上下文协议)工具连接起来,实现自动化工具调用和聊天交互。

  • by umarajgordian
  • HTML
  • 本地部署
  • 更新于
在 GitHub 查看 umarajgordian/MCPCalculatorDemo

使用说明

简单的MCP+AAzure OpenAI应用程序

一个简单的FastAPI应用程序,将Azure OpenAI与MCP(模型上下文协议)工具连接起来。

🚀 快速开始

1.安装依赖项

在VS Code中打开终端并运行:

pip install mcp fastapi uvicorn openai httpx

2.配置Azure OpenAI

编辑 config.py 并添加您的Azure OpenAI凭据:

OPENAI_API_KEY = "your-api-key-here"
OPENAI_API_BASE = "your-endpoint-here"  # e.g., "https://your-resource.openai.azure.com/"
OPENAI_API_TYPE = "azure"
OPENAI_API_VERSION = "2024-02-15-preview"
OPENAI_MODEL_NAME = "gpt-4.1"

3.测试MCP服务器(可选)

首先,让我们测试一下MCP服务器是否正常工作:

python mcp_server.py

它应该没有错误地开始。按 Ctrl+C 阻止它。

4.运行应用程序

启动FastAPI服务器:

python app.py

您应该看到:

INFO:     Started server process
INFO:     Uvicorn running on http://127.0.0.1:8000

5.打开用户界面

打开浏览器并转到:

http://127.0.0.1:8000

📝 如何使用

  1. 在聊天框中键入消息
  2. 请尝试以下示例:
    • “现在几点了?”
    • “计算25*4”
    • “100除以5等于多少?”
    • “加50和75”

该应用程序将:

  • 将您的消息发送到Azure OpenAI
  • Azure OpenAI将决定是否需要使用MCP工具
  • 如果需要工具,它们将被自动调用
  • 您将在聊天中看到工具调用和结果

🔧 可用的MCP工具

  1. get_current时间 -获取当前日期和时间
  2. 计算 -执行基本算术(加、减、乘、除)

📁 文件概述

  • app.py -连接Azure OpenAI和MCP的FastAPI后端
  • mcp_server.py -提供工具的MCP服务器
  • index.html -简单的web UI
  • config.py -Azure OpenAI配置

🐛 故障排除

“找不到模块”错误

确保您安装了所有依赖项:

pip install mcp fastapi uvicorn openai httpx

Azure OpenAI错误

  • 在中检查API密钥和终结点 config.py
  • 确保您的模型部署名称正确(gpt-4.1)
  • 验证您的API版本是否兼容

MCP服务器错误

  • 确保 mcp_server.py 与位于同一目录中 app.py
  • 检查MCP包是否已安装: pip install mcp

🎯 后续步骤

您想进一步扩展此功能吗?你可以:

  1. 添加更多工具 mcp_server.py
  2. 在中自定义UI index.html
  3. 向FastAPI应用程序添加身份验证
  4. 部署到云服务

📚 API终点

  • GET / -主聊天界面
  • GET /api/tools -列出可用的MCP工具
  • POST /api/chat -发送聊天消息
  • POST /api/reset -重置对话历史记录

享受你的MCP+Azure OpenAI应用程序! 🎉