Weather App

🚀 天氣應用

這是一個基於命令行和MCP（MindSpire Command Protocol）的天氣應用程序，能提供全球任意地點的當前天氣狀況、預報及警報信息，讓你隨時隨地掌握天氣動態。

🚀 快速開始

運行天氣應用，只需執行以下命令：

./scripts/run_weather.sh

這將啟動MCP服務器，提供一系列實用工具，如獲取當前天氣、預報、警報等。

✨ 主要特性

• 🌦️ 獲取任何位置的當前天氣條件
• 📅 獲取每日天氣預報
• ⏱️ 獲取逐小時天氣預報
• ⚠️ 獲取天氣警報
• 📍 按座標獲取天氣
• 📌 自動定位檢測
• 🛠️ 測試API連接狀態
• 🔑 檢查API密鑰及訂閱信息

📦 安裝指南

先決條件

• Python 3.12或更高版本
• uv 包管理器

安裝步驟

1. 克隆此倉庫：

git clone <repository-url>
cd weather-app

2. 在根目錄下創建一個.env文件，並添加您的OpenWeatherMap API密鑰：

OPENWEATHER_API_KEY=your_api_key_here

您可以從此處獲取API密鑰：OpenWeatherMap。 3. 運行安裝腳本：

./scripts/install.sh

用於開發環境時，請使用：

./scripts/install.sh --dev

💻 使用示例

基礎用法

運行以下命令啟動MCP服務器後，可使用以下工具：

./scripts/run_weather.sh

• get_current_weather：獲取當前天氣狀況
• get_forecast：獲取每日天氣預報
• get_hourly_forecast：獲取逐小時天氣預報
• get_alerts：獲取天氣警報
• get_weather_by_coordinates：按座標獲取天氣
• get_user_location：獲取您的當前位置
• test_api_connection：測試API連接狀態
• check_api_key_and_subscription：檢查API密鑰及訂閱信息

📚 詳細文檔

開發指南

代碼風格與Linting（代碼格式檢查）

該項目使用以下工具確保代碼質量：

• Black 進行代碼格式化
• isort 進行導入排序
• Ruff 進行代碼檢查
• mypy 進行類型檢查 所有工具的配置信息均在pyproject.toml文件中。

預提交鉤（Pre-commit Hooks）

我們使用預提交鉤確保代碼質量。安裝開發依賴後，鉤子會自動設置。 要手動安裝預提交鉤：

uv run pre-commit install

要手動運行所有鉤子：

uv run pre-commit run --all-files

測試

運行測試：

./scripts/run_tests.sh

帶覆蓋率運行：

./scripts/run_tests.sh --coverage

運行集成測試（需要API密鑰）：

./scripts/run_tests.sh --integration

帶覆蓋率的集成測試：

./scripts/run_tests.sh --integration --coverage

創建MCP服務器

使用此項目作為模板創建自己的MCP服務器：

1. 使用開發依賴安裝項目：

./scripts/install.sh --dev

2. 創建一個新的Python腳本，並添加以下內容：

from mindspire_protocol import MCPProtocol

# 按照需求實現具體的業務邏輯
class MyMCPServer:
    def handle_command(self, command: str) -> str:
        # 實現具體的命令處理邏輯
        pass

if __name__ == "__main__":
    server = MyMCPServer()
    mcp_protocol = MCPProtocol(server)
    mcp_protocol.start_listening()

3. 根據需求擴展和實現具體業務功能。

📄 許可證

該項目遵循MIT License協議。