README.md•4.72 kB
# 天气查询MCP服务器
基于百度地图API提供天气查询功能的MCP（Model Context Protocol）工具。
## 服务配置
```json
{
"mcpServers": {
"weather-mcp": {
"command": "python",
"args": ["-m", "weather_mcp.server"]
}
}
}
```
**环境变量配置**：
请在系统环境变量中设置：
```bash
BAIDU_AK=your_baidu_ak_here
```
## 功能特性
- 🌤️ **实时天气查询** - 获取当前天气状况、温度、湿度、风向等信息
- 📅 **天气预报** - 提供未来5天的详细天气预报
- 📊 **生活指数** - 包含晨练、洗车、感冒、紫外线、穿衣、运动等生活指数
- ⚠️ **气象预警** - 实时获取气象预警信息
- ⏰ **逐小时预报** - 24小时逐小时天气预报
- 🗺️ **多种查询方式** - 支持行政区划代码和经纬度坐标查询
## 安装依赖
```bash
pip install -r requirements.txt
```
## 配置
设置系统环境变量：
**Windows**：
```cmd
set BAIDU_AK=your_baidu_ak_here
```
**Linux/macOS**：
```bash
export BAIDU_AK=your_baidu_ak_here
```
或者在系统环境变量中永久设置 `BAIDU_AK`。
### 获取百度地图API密钥
1. 访问 [百度地图开放平台](https://lbsyun.baidu.com/)
2. 注册并登录账号
3. 创建应用并获取AK（API Key）
4. 确保开通天气服务权限
## 使用方法
### 启动MCP服务器
```bash
python server.py
```
### 工具说明
#### get_weather
获取指定地区的天气信息，支持多种数据类型和查询方式。
**参数：**
- `district_id` (可选): 区县的行政区划编码，例如：'110101'（北京东城区）
- `location` (可选): 经纬度坐标，格式：'经度,纬度'，例如：'116.404,39.915'
- `data_type` (可选): 请求数据类型
- `now`: 实时天气
- `fc`: 天气预报
- `index`: 生活指数
- `alert`: 气象预警
- `fc_hour`: 逐小时预报
- `all`: 所有数据（默认）
- `coordtype` (可选): 坐标类型，仅在使用location时有效
- `wgs84`: WGS84坐标系（默认）
- `bd09ll`: 百度经纬度坐标系
- `bd09mc`: 百度墨卡托坐标系
- `gcj02`: 国测局坐标系
**注意：** `district_id` 和 `location` 必须提供其中一个。
### 使用示例
#### 1. 使用行政区划代码查询北京东城区天气
```json
{
"name": "get_weather",
"arguments": {
"district_id": "110101",
"data_type": "all"
}
}
```
#### 2. 使用经纬度查询天安门广场天气
```json
{
"name": "get_weather",
"arguments": {
"location": "116.404,39.915",
"data_type": "all",
"coordtype": "wgs84"
}
}
```
#### 3. 只查询实时天气
```json
{
"name": "get_weather",
"arguments": {
"district_id": "110101",
"data_type": "now"
}
}
```
## 测试
### 测试百度地图API连接
```bash
python test_baidu_api.py
```
### 测试MCP服务器功能
```bash
python test_mcp_server.py
```
## 项目结构
```
weather_query/
├── server.py # MCP服务器主文件
├── requirements.txt # Python依赖
├── .env # 环境变量配置
├── .env.example # 环境变量模板
├── test_baidu_api.py # API测试脚本
├── test_mcp_server.py # MCP服务器测试脚本
├── pyproject.toml # 项目配置
├── setup.py # 安装脚本
├── __init__.py # 包初始化文件
└── README.md # 项目说明文档
```
## 常见问题
### Q: 如何获取行政区划代码？
A: 行政区划代码是中国标准的区县编码。常见的代码包括：
- 110101: 北京市东城区
- 110102: 北京市西城区
- 310101: 上海市黄浦区
- 440101: 广州市荔湾区
您可以通过百度地图API的其他接口或相关文档获取完整的行政区划代码列表。
### Q: 支持哪些坐标系？
A: 支持以下坐标系：
- WGS84: 国际标准坐标系
- BD09LL: 百度经纬度坐标系
- BD09MC: 百度墨卡托坐标系
- GCJ02: 国测局坐标系（火星坐标系）
### Q: API调用频率限制？
A: 请参考百度地图开放平台的API调用频率限制说明。建议合理使用API，避免频繁调用。
## MCP服务配置
### 本地使用配置
```json
{
"mcpServers": {
"weather-mcp": {
"command": "python",
"args": ["-m", "weather_mcp.server"]
}
}
}
```
### 托管部署配置
```json
{
"mcpServers": {
"weather-mcp": {
"command": "python",
"args": ["-m", "weather_mcp.server"]
}
}
}
```
**注意**：使用前请确保已在系统环境变量中设置 `BAIDU_AK`。
## 许可证
MIT License
## 贡献
欢迎提交Issue和Pull Request来改进这个项目！