Weather MCP Server Ujh

🚀 天氣 MCP 項目

本項目基於 Model Context Protocol (MCP) 構建了一個天氣相關服務。該服務不僅能提供天氣警報與天氣預報功能，還配備系統工具，可執行 shell 命令並查看系統資源，為用戶帶來便捷的使用體驗。

🚀 快速開始

📦 安裝依賴

使用 pip 安裝所需的依賴庫：

pip install "mcp[server]" requests

⚙️ 初始化項目

創建一個新的 MCP 服務器實例，並註冊天氣工具和系統資源：

from mcp import Server
import subprocess
import requests

server = Server()

# 註冊天氣工具
@server.tool()
async def get_weather_alerts(state: str) -> dict:
    """
    獲取指定州的天氣警報信息。
    
    Args:
        state: 州碼（例如："CA", "NY", "FL"）
        
    Returns:
        天氣警報的詳細信息
    """
    # 實現獲取天氣警報的具體邏輯
    return {"state": state, "alerts": []}

@server.tool()
async def get_forecast(latitude: float, longitude: float) -> dict:
    """
    獲取指定緯度和經度位置的天氣預報。
    
    Args:
        latitude: 緯度座標
        longitude: 經度座標
        
    Returns:
        天氣預報的數據
    """
    # 實現獲取天氣預報的具體邏輯
    return {"latitude": latitude, "longitude": longitude, "forecast": []}

# 註冊系統資源
@server.resource()
def top_processes() -> str:
    """
    獲取系統的進程信息。
    
    Returns:
        進程信息的字符串表示
    """
    # 實現獲取進程信息的具體邏輯
    return subprocess.run("ps aux", capture_output=True, text=True).stdout

# 啟動服務器
server.start()

▶️ 運行服務器

啟動 MCP 服務器：

python your_server_script.py

✨ 主要特性

• 🌩️ 天氣警報：通過輸入州碼（例如："CA", "NY", "FL"），獲取指定區域的天氣警報信息。
• 🌤️ 天氣預報：通過提供緯度和經度座標，獲取該位置的天氣預報數據。
• 💻 系統工具：執行任意 shell 命令並查看結果。
• 📊 資源瀏覽：查看可用的系統資源及其當前狀態。

💻 使用示例

🧪 測試工具

使用 MCP CLI 工具測試已註冊的工具和資源：

1. 列出所有可用工具：

   mcp list-tools http://localhost:8000
   

2. 調用獲取天氣警報工具：

   mcp call-tool http://localhost:8000 get_weather_alerts --args '{"state": "CA"}'
   

3. 獲取天氣預報：

   mcp call-tool http://localhost:8000 get_forecast --args '{"latitude": 37.7749, "longitude": -122.4194}'
   

4. 查看系統資源：

   mcp list-resources http://localhost:8000
   

5. 獲取進程信息：

   mcp get-resource http://localhost:8000 top_processes
   

🔍 使用 MCP Inspector 進行調試

MCP Inspector 是一個 Web 界面工具，可以幫助開發者探索和測試 MCP 服務器的功能：

1. 啟動 MCP Inspector：

   make dev-server
   

2. 打開瀏覽器訪問 http://localhost:5173
3. 在 Inspector 中探索工具、調用工具、瀏覽資源以及調試問題。

📚 詳細文檔

➕ 添加新工具

要添加新的工具，請按照以下步驟操作：

1. 在相應的工具模塊中創建函數。
2. 使用 @server.tool() 裝飾器註冊該函數。
3. 更新 tools/__init__.py 中的工具註冊信息。

示例代碼如下：

@server.tool()
async def my_new_tool(param1: str, param2: int) -> str:
    """
    工具描述。
    
    Args:
        param1: 參數 1 的描述
        param2: 參數 2 的描述
        
    Returns:
        返回值的描述
    """
    # 實現工具的具體邏輯
    return 結果

➕ 添加新資源

要添加新的資源，請按照以下步驟操作：

1. 在相應的資源模塊中創建函數。
2. 使用 @server.resource() 裝飾器註冊該函數。
3. 更新 resources/__init__.py 中的資源註冊信息。

📁 項目結構

your_project/
├── server.py          # MCP 服務器實現
├── tools/            # 工具模塊
│   ├── weather.py    # 天氣工具
│   └── system.py     # 系統工具
├── resources/        # 資源模塊
│   ├── weather_data.py  # 天氣數據資源
│   └── system_info.py   # 系統信息資源
└── requirements.txt  # 依賴管理文件

📦 依賴管理

項目的依賴項已包含在 requirements.txt 文件中，使用 pip 安裝即可：

pip install -r requirements.txt

📄 許可證

本項目遵循 MIT 許可證。請查看 LICENSE 文件獲取詳細信息。

🤝 貢獻指南

歡迎貢獻！請參考 CONTRIBUTING.md 獲取如何參與開發的詳細指南。

這個項目展示瞭如何利用 MCP 協議快速搭建一個集成天氣服務和系統工具的功能平臺。通過擴展工具和資源模塊，可以進一步增強其功能和適用場景。