Azure容器应用程序远程MCP服务器示例

此MCP服务器使用SSE传输并使用API密钥进行身份验证。

项目概述

这是一个基于FastAPI的模型上下文协议（MCP）服务器，专为Azure容器应用设计。它通过安全的、受API密钥保护的Server-Sent事件（SSE）接口提供天气相关工具（如警报和预报）。该服务器旨在与MCP兼容客户端集成，例如Visual Studio Code或自定义脚本。

设置说明

1. 克隆仓库：

   git clone https://github.com/KRVaghani/Azure-MCP-Server.git
   cd Azure-MCP-Server
   

2. 安装先决条件：
   • Python 3.11或更高版本
   • uv
3. 设置虚拟环境和依赖项：

   uv venv
   uv sync
   

4. 设置API密钥：

   export API_KEYS=devkey  # 或您选择的密钥
   

5. 运行服务器：

   uv run fastapi dev main.py
   

客户端使用

包含一个用于命令行交互的示例Python客户端（model_request_client.py）：

python model_request_client.py

• 输入您的API密钥（默认为devkey）
• 选择工具：get_alerts（按美国州）或get_forecast（按纬度/经度）
• 输入所需的参数
• 服务器响应将在终端中显示

API端点

• /sse（GET）：主要的SSE端点，用于MCP协议通信。需要x-api-key头。
• /messages（SSE）：内部使用的消息流端点（基于会话）。

示例curl测试

curl -H "x-api-key: devkey" http://localhost:8000/sse

故障排除

• 如果看到ModuleNotFoundError，请确保激活了虚拟环境并且安装了依赖项。
• 如果客户端挂起，请检查服务器是否在运行且API密钥匹配。
• 对于venv中的pip问题，运行：

  python -m ensurepip --upgrade
  python -m pip install --upgrade pip
  

贡献

欢迎拉取请求！请先打开问题讨论主要更改。

许可证

MIT许可证（如需添加LICENSE文件）

本地运行

前提条件：

• Python 3.11或更高版本
• uv

本地运行服务器：

uv venv
uv sync

# Linux/macOS
export API_KEYS=<AN_API_KEY>
# Windows
set API_KEYS=<AN_API_KEY>

uv run fastapi dev main.py

VS Code MCP配置（mcp.json）：

{
    "inputs": [
        {
            "type": "promptString",
            "id": "weather-api-key",
            "description": "Weather API Key",
            "password": true
        }
    ],
    "servers": {
        "weather-sse": {
            "type": "sse",
            "url": "http://localhost:8000/sse",
            "headers": {
                "x-api-key": "${input:weather-api-key}"
            }
        }
    }
}

部署到Azure容器应用

az containerapp up -g <RESOURCE_GROUP_NAME> -n weather-mcp --environment mcp -l westus --env