Azure MCP Server

🚀 Azure容器應用程序遠程MCP服務器示例

本項目是一個基於FastAPI的模型上下文協議（MCP）服務器，專為Azure容器應用設計。它藉助安全的、受API密鑰保護的Server-Sent事件（SSE）接口，提供天氣相關工具（如警報和預報），能與MCP兼容客戶端（如Visual Studio Code或自定義腳本）集成。

🚀 快速開始

此MCP服務器使用SSE傳輸並使用API密鑰進行身份驗證。下面為你介紹如何快速搭建和使用該服務器。

✨ 主要特性

• 基於FastAPI構建，專為Azure容器應用設計。
• 通過安全的、受API密鑰保護的Server-Sent事件（SSE）接口提供服務。
• 提供天氣相關工具，如警報和預報。
• 可與MCP兼容客戶端集成，例如Visual Studio Code或自定義腳本。

📦 安裝指南

克隆倉庫

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

安裝先決條件

• Python 3.11或更高版本
• uv

設置虛擬環境和依賴項

uv venv
uv sync

設置API密鑰

export API_KEYS=devkey  # 或您選擇的密鑰

運行服務器

uv run fastapi dev main.py

💻 使用示例

基礎用法

本項目包含一個用於命令行交互的示例Python客戶端（model_request_client.py），你可以按以下步驟操作：

python model_request_client.py

• 輸入您的API密鑰（默認為devkey）
• 選擇工具：get_alerts（按美國州）或get_forecast（按緯度/經度）
• 輸入所需的參數
• 服務器響應將在終端中顯示

高級用法

你可以使用curl命令進行測試：

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

📚 詳細文檔

API端點

• /sse（GET）：主要的SSE端點，用於MCP協議通信。需要x-api-key頭。
• /messages（SSE）：內部使用的消息流端點（基於會話）。

🔧 技術細節

本項目是一個基於FastAPI的MCP服務器，通過Server-Sent事件（SSE）接口提供服務。SSE是一種允許服務器向客戶端發送即時更新的技術，非常適合需要即時數據的應用場景。服務器使用API密鑰進行身份驗證，確保只有授權的客戶端可以訪問服務。

📄 許可證

本項目採用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

故障排除

• 如果看到ModuleNotFoundError，請確保激活了虛擬環境並且安裝了依賴項。
• 如果客戶端掛起，請檢查服務器是否在運行且API密鑰匹配。
• 對於venv中的pip問題，運行：

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

貢獻

歡迎拉取請求！請先打開問題討論主要更改。