Codebywaqas Weather MCP Server

🚀 天氣 MCP 服務器

一個使用 OpenWeatherMap API 提供天氣信息的現代代碼協議（MCP）服務器，能讓你輕鬆獲取即時且詳細的天氣數據。

✨ 主要特性

• 即時獲取天氣數據，讓你第一時間掌握天氣變化。
• 以度為單位顯示溫度，直觀清晰。
• 提供詳細的天氣信息，涵蓋：
  • 溫度
  • 溼度
  • 風速
  • 日出/日落時間
  • 天氣描述

📦 安裝指南

使用 Smithery 安裝

通過 Smithery 可自動安裝 Claude Desktop 的 Weather MCP Server：

npx -y @smithery/cli install @CodeByWaqas/weather-mcp-server --client claude

手動安裝

1. 克隆倉庫。
2. 創建虛擬環境：

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上使用：.venv\Scripts\activate

3. 安裝依賴項：

pip install -e .

📚 詳細文檔

設置說明

配置與 Claude Desktop 使用

# claude_desktop_config.json
# 可通過以下路徑找到位置：
# Claude -> 設置 -> 開發者 -> 編輯配置
{
  "mcpServers": {
      "mcp-weather-project": {
          "command": "uv",
          "args": [
              "--directory",
              "/<絕對路徑>/weather-mcp-server/src/resources",
              "run",
              "server.py"
          ],
          "env": {
            "WEATHER_API_KEY": "YOUR_API_KEY"
          }
      }
  }
}

開發/本地設置說明

克隆倉庫

git clone https://github.com/CodeByWaqas/weather-mcp-server

安裝依賴項

安裝 MCP 服務器的依賴項：

cd weather-mcp-server

# 創建虛擬環境並激活它
uv venv

source .venv/bin/activate # MacOS/Linux
# 或者
.venv/Scripts/activate # Windows

# 安裝依賴項
uv add "mcp[cli]" python-dotenv requests httpx

配置

1. 複製 src/resources/env.example 到 src/resources/.env。
2. 將你的 OpenWeatherMap API 密鑰添加到 .env 文件中：

WEATHER_API_KEY=your_api_key_here

🚀 快速開始

運行 Claude Desktop 並使用 LLM 獲取天氣信息。

📄 許可證

此項目在 MIT 許可證下，詳情請見 LICENSE 文件。