MCP O7b

🚀 天氣 MCP 服務器

這是一個基於 FastMCP 構建的天氣查詢服務器，能為用戶提供全球城市的天氣信息查詢服務，滿足不同用戶對天氣數據的需求。

✨ 主要特性

• 🌍 支持全球城市天氣查詢，無論您身處何地，都能輕鬆獲取當地天氣。
• 🌡️ 提供溫度、溼度和天氣描述信息，讓您全面瞭解天氣狀況。
• 🔄 支持攝氏度和華氏度溫度單位切換，滿足不同用戶的使用習慣。
• 🛠️ 基於 Model Context Protocol (MCP) 實現，確保系統的高效穩定運行。
• 📝 完整的日誌記錄，方便後續問題排查和系統優化。

📦 安裝指南

安裝要求

• Python 3.8+
• OpenWeatherMap API 密鑰
• uv (Python 包管理工具)

🚀 快速開始

1. 克隆倉庫：

git clone <repository-url>
cd weather-mcp-server

2. 安裝依賴：

make install

3. 設置環境變量： 創建 .env 文件並添加以下內容：

OPENWEATHER_API_KEY=你的OpenWeatherMap_API密鑰

4. 運行服務器：

make run

💻 使用示例

選項 1：使用 uvx（推薦）

使用 uvx 可以自動從 PyPI 安裝包，無需克隆倉庫。將以下配置添加到 Claude Desktop 的配置文件 claude_desktop_config.json 中：

{
  "mcpServers": {
    "weather-mcp-server": {
      "command": "uvx",
      "args": [
        "weather-mcp-server"
      ],
      "env": {
        "OPENWEATHER_API_KEY": "你的OpenWeatherMap_API密鑰"
      }
    }
  }
}

選項 2：本地開發模式

1. 克隆倉庫並安裝依賴：

git clone <repository-url>
cd weather-mcp-server
make install

2. 設置環境變量： 創建 .env 文件並添加以下內容：

OPENWEATHER_API_KEY=你的OpenWeatherMap_API密鑰

3. 在 Claude Desktop 配置文件中添加：

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/weather_mcp_server",
        "run",
        "weather-mcp-server"
      ],
      "env": {
        "OPENWEATHER_API_KEY": "你的OpenWeatherMap_API密鑰"
      }
    }
  }
}

配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

重啟 Claude Desktop 以加載新的 MCP 服務器。

🔧 技術細節

開發

本項目使用 Makefile 來簡化常用命令。

可用命令

make install  # 安裝依賴
make format   # 格式化代碼
make lint     # 運行代碼檢查
make clean    # 清理臨時文件
make run      # 運行服務器

發佈新版本

make release version=v0.1.0

📚 詳細文檔

MCP 工具

服務器提供以下 MCP 工具：

get_weather

獲取指定城市的天氣信息。

參數：

• city: 城市名稱（必填）
• units: 溫度單位（可選，默認為 "metric"）
  • "metric": 攝氏度
  • "imperial": 華氏度

示例請求：

{
    "name": "get_weather",
    "kwargs": {
        "city": "Beijing",
        "units": "metric"
    }
}

示例響應：

{
    "temperature": 20.5,
    "humidity": 65,
    "description": "晴",
    "city": "Beijing"
}

現在您可以通過 Claude 使用自然語言查詢天氣，例如：

• "北京的天氣如何？"
• "紐約當前的溫度是多少？"
• "告訴我大阪的天氣情況。"