Weather MCP

🚀 天氣MCP服務器

這是一個MCP服務器，具備以下功能：

• 根據美國雙字母州代碼提供美國國家氣象局（NWS）的即時警報。
• 根據經緯度座標提供短期點位預報（未來5個時段）。

數據來源於美國國家氣象局的公共API：https://api.weather.gov 。

✨ 主要特性

本服務器提供了兩個實用工具，具體信息如下：

📦 安裝指南

安裝依賴

pip install .

運行MCP服務器（標準輸入輸出傳輸）

python -m weather.weather

你的MCP客戶端應配置為通過包入口點或上述模塊路徑來啟動服務器。

💻 使用示例

基礎用法

可參考上述安裝和運行步驟在本地啟動服務器，然後使用提供的工具獲取天氣信息。例如，使用 get_alerts 工具獲取某個州的即時警報：

# 假設已經正確導入相關模塊和工具
result = get_alerts(state="CA")  # 獲取加利福尼亞州的即時警報
print(result)

高級用法

可根據實際需求，結合不同的輸入參數，靈活使用 get_alerts 和 get_forecast 工具。例如，獲取特定經緯度的短期預報：

# 假設已經正確導入相關模塊和工具
latitude = 34.0522
longitude = -118.2437
result = get_forecast(latitude=latitude, longitude=longitude)
print(result)

📚 詳細文檔

服務器JSON摘要

有關注冊表元數據（包括名稱、版本、工具和入口點配置），請參閱 server.json。

發佈步驟概述

1. 使用發佈者進行身份驗證（GitHub命名空間）

mcp-publisher login github

2. 創建並將倉庫推送到GitHub（具體步驟見下文）
3. （可選）如果作為包分發，發佈到PyPI
4. 發佈到MCP註冊表

mcp-publisher publish

5. 驗證

curl "https://registry.modelcontextprotocol.io/v0/servers?search=io.github.vtiwari/weather-mcp"

創建並推送GitHub倉庫

如果該目錄還不是一個git倉庫

git init
git add .
git commit -m "Initial commit: Weather MCP server"

使用GitHub CLI創建並推送倉庫

gh repo create vtiwari/weather-mcp --public --source . --remote origin --push

如果不使用GitHub CLI

手動通過GitHub網頁界面創建倉庫，然後執行以下命令：

git remote add origin https://github.com/vtiwari/weather-mcp.git
git branch -M main
git push -u origin main

為版本發佈打標籤以保持一致性

git tag v0.1.0
git push origin v0.1.0

PyPI打包（可選）

若要通過PyPI進行分發，需確保 pyproject.toml 包含構建後端和元數據（作者、許可證）。然後執行以下命令：

pip install build twine
python -m build
twine upload dist/*

📄 許可證

本項目採用MIT許可證（如有不同請自行調整）。

⚠️ 重要提示

此服務器使用美國國家海洋和大氣管理局（NOAA）/國家氣象局（NWS）的公共端點。請遵守API使用指南和速率限制。