MCP Hge

一個基於MCP協議的天氣查詢命令行工具，通過客戶端-服務器架構連接美國國家氣象局API，支持自然語言查詢天氣警報和預報。

位置服務開發者工具 #天氣查詢 #MCP協議 #自然語言 #客戶端服務 .Python

評分 : 2.5分

下載量 : 7.0K

更新時間 : 2025-04-23

打開站點

什麼是MCP天氣服務器？

MCP天氣服務器是一個基於模型上下文協議（MCP）構建的客戶端-服務器架構工具。它允許用戶通過自然語言查詢美國的天氣數據，例如當前天氣警報和詳細的天氣預報。

如何使用MCP天氣服務器？

您需要啟動服務器和客戶端，然後通過命令行輸入您的查詢。例如，您可以詢問特定州的天氣警報或某個地點的天氣預報。

適用場景

適用於需要快速獲取美國地區天氣信息的個人用戶、企業或開發者。

主要功能

查詢天氣警報

支持通過兩字母州代碼查詢指定州的天氣警報。

獲取天氣預報

支持通過緯度和經度獲取詳細天氣預報。

自然語言處理

利用Google Gemini AI實現自然語言查詢解析。

客戶端-服務器架構

支持分佈式部署，提高靈活性和擴展性。

優勢

基於MCP協議，易於集成和擴展。

自然語言查詢，無需複雜命令。

即時天氣數據，來自官方NWS API。

跨平臺支持，適用於多種操作系統。

侷限性

需要穩定的網絡連接以訪問外部API。

可能需要API密鑰來啟用某些高級功能。

對非英語查詢的支持有限。

如何使用

安裝依賴

確保安裝Python 3.8+，並設置虛擬環境。

配置環境變量

在項目根目錄創建`.env`文件，並添加您的Gemini API密鑰。

啟動服務器

運行`python server.py`啟動MCP服務器。

連接客戶端

運行`python client.py`連接到服務器並開始查詢。

使用案例

查詢天氣警報

查詢加利福尼亞州的當前天氣警報。

獲取天氣預報

查詢舊金山的天氣預報。

常見問題

如何安裝MCP天氣服務器？

需要哪些API密鑰？

如何退出客戶端？

🚀 MCP 天氣工具

MCP 天氣工具是一個基於 MCP 協議的簡單命令行工具，藉助客戶端 - 服務器架構，讓用戶可以訪問美國天氣數據。同時，它利用 Google 的 Gemini AI 提供自然語言接口，方便用戶查詢天氣信息。

🚀 快速開始

MCP 天氣工具連接了 Python 客戶端應用程序和天氣數據服務器，用戶在查詢天氣信息時能夠使用自然語言。服務器藉助模型上下文協議（MCP）與國家氣象局 API 通信，獲取天氣警報和預報。

✨ 主要特性

支持使用州代碼查詢美國各州的當前天氣警報。
可通過緯度和經度獲取特定位置的詳細天氣預報。
採用 Google 的 Gemini AI 提供自然語言接口。
基於模型上下文協議（MCP）實現客戶端 - 服務器架構。

📦 安裝指南

先決條件

Python 3.8+
Node.js（如果運行 JavaScript 服務器）
Google Gemini API 密鑰

安裝步驟

克隆倉庫：

git clone https://github.com/Abhinavexists/MCP_Server.git
cd weather-tool

如果沒有 uv，請安裝它：
```
pip install uv
```
創建並激活虛擬環境：
- 在 Windows 上：.venv\Scripts\activate
- 在 macOS/Linux 上：source .venv/bin/activate
使用 uv 安裝依賴項（該項目使用 uv.lock 和 pyproject.toml）：
```
uv pip sync
```
創建項目根目錄中的 .env 文件，並添加您的 Gemini API 密鑰：
```
GEMINI_API_KEY=your_gemini_api_key_here
```

💻 使用示例

基礎用法

運行客戶端並連接到天氣服務器：
```
python client.py server.py
```
連接後，您可以詢問有關天氣信息的問題：
- 查詢：加利福尼亞州當前有哪些天氣警報？
- 查詢：緯度 37.7749 和經度 -122.4194 的位置的天氣預報是什麼？
輸入 quit 退出應用程序。