# MCP Weather Server
這是一個基於Model Context Protocol (MCP)的天氣資訊服務器，使用OpenWeatherMap API提供即時天氣資訊和天氣預報功能。
## 功能特點
- 獲取城市當前天氣資訊
- 獲取城市5天天氣預報
- 支持中英文城市名稱查詢
- 完整的錯誤處理機制
- 豐富的天氣資訊顯示（溫度、濕度、風速等）
## 系統要求
- Python >= 3.10
- OpenWeatherMap API金鑰
## 安裝
1. 確保您已安裝 Python 3.10 或更高版本
2. 使用以下命令安裝依賴套件：
```bash
uv venv
uv pip install -r requirements.txt
```
## 配置
在 `mcp.json` 中配置您的OpenWeatherMap API金鑰：
```json
{
"mcpServers": {
"weather": {
"command": "uv",
"args": ["--directory", ".", "run", "main.py"],
"description": "天氣資訊伺服器 - 取得當前天氣和天氣預報",
"env": {
"OPENWEATHER_API_KEY": "your_api_key_here"
}
}
}
}
```
## 使用方法
### 作為MCP服務器運行
```bash
python main.py
```
### 使用客戶端
```bash
python client.py
```
## API參考
### 獲取當前天氣
```python
get_current_weather(city: str) -> str
```
- 參數：
- city: 城市名稱（支持中英文）
- 返回：格式化的當前天氣資訊
### 獲取天氣預報
```python
get_weather_forecast(city: str, days: int = 5) -> str
```
- 參數：
- city: 城市名稱（支持中英文）
- days: 預報天數（1-5天，預設5天）
- 返回：格式化的天氣預報資訊
## 資源端點
- `weather://current/{city}` - 獲取指定城市的當前天氣資源
- `weather://forecast/{city}` - 獲取指定城市的天氣預報資源
- `weather://api-status` - 獲取API狀態資訊
## 授權
MIT License
## 貢獻
歡迎提交問題和拉取請求！
## 致謝
- [OpenWeatherMap](https://openweathermap.org/) - 天氣數據提供
- [Model Context Protocol](https://www.claudemcp.com/zh/docs/mcp-py-sdk-basic) - MCP協議支持
## 部署
關於部署的詳細信息，請參考 [部署指南](DEPLOY.md)。
支持的部署方式：
- 直接部署（Python 環境）
- Docker 部署
- Docker Compose 部署
- 系統服務部署（Linux）
