Mcp Server Weather Example

部署并连接远程 MCP 天气服务

本项目可让你部署一个基于云的 Model Context Protocol（MCP） 服务，通过美国国家气象局 API 提供实时天气数据。本项目使用 FastAPI 构建，支持通过服务器发送事件（SSE）进行实时通信，并采用安全的 API 密钥身份验证。

此存储库提供一个可直接部署的 Weather MCP 服务。你将了解完整的设置流程：从克隆代码、配置身份验证、部署到 Azure Container Apps，到最后通过 MCP 扩展在 Visual Studio Code 中进行连接。

---

克隆存储库

git clone https://github.com/your-username/mcp-weather-server.git
cd mcp-weather-server

---

了解项目结构

部署前，请先熟悉核心组件：

• weather.py – 使用美国国家气象局 API 定义两个工具：get_alerts() 和 get_forecast()。
• main.py – 将这些工具封装在一个 FastAPI 应用中，并通过 /sse 暴露，支持 SSE。
• api_key_auth.py – 为传入请求实现基于 x-api-key 请求头的安全机制。
• Dockerfile – 使用 Python 3.13 和 uv Web 服务器构建并打包应用。

---

配置 API 密钥身份验证

通过环境变量安全地设置 API 密钥：

export API_KEYS=<YOUR_API_KEY>

你也可以提供多个以逗号分隔的密钥。无需将密钥硬编码到源代码中。

---

构建并部署到 Azure Container Apps

使用 Azure CLI 一步完成构建和部署：

az containerapp up \
  -g <RESOURCE_GROUP> \
  -n weather-mcp \
  --environment <CONTAINERAPPS_ENV_NAME> \
  -l westus \
  --env-vars API_KEYS=<YOUR_API_KEY> \
  --source .

此命令将：

• 使用附带的 Dockerfile 构建镜像。
• 将其部署到 Azure Container Apps。
• 通过 --env-vars 注入 API 密钥。

部署完成后，Azure CLI 将返回一个公开 URL，这是 MCP 客户端将使用的端点。

---

从 Visual Studio Code 连接

服务启动后，可在 VS Code 中连接：

1. 在项目中创建 .vscode/mcp.json 文件：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "weather-api-key",
      "description": "Weather API Key",
      "password": true
    }
  ],
  "servers": {
    "weather-sse": {
      "type": "sse",
      "url": "https://weather-mcp.orangebush.westus.azurecontainerapps.io/sse",
      "headers": {
        "x-api-key": "${input:weather-api-key}"
      }
    }
  }
}

2. 在 VS Code 中打开 MCP 扩展侧边栏。
3. 点击服务条目旁边的 Start。
4. 按提示输入 API 密钥。

现在已连接成功，可以处理实时天气查询了。

---

使用 GitHub Copilot Chat（Agent 模式）试用

1. 在 Agent mode 下启动 GitHub Copilot Chat。
2. 提出类似这样的问题：

"佐治亚州的天气预报怎么样？"

Agent 会在后台调用你的 get_forecast 工具，并根据 NWS 数据返回实时天气预报。

---

一切就绪！

你的 MCP 服务现在已经：

• 托管在云端
• 受 API 密钥保护
• 已与 VS Code 和 GitHub Copilot 集成

现在，你可以构建自定义 Agent，从任何地方与实时天气数据交互。