AMap-Weather-MCP: 基于高德地图API的MCP天气服务器#

项目初衷#

在开发 AI 应用时，我发现获取准确的天气信息是一个常见需求。虽然有许多天气 API 可用，但它们往往需要复杂的配置和认证流程，而且大多数都没有针对 MCP（Model Context Protocol）生态系统进行优化。

AMap Weather MCP 的诞生是为了解决这些问题：

• 简化集成：提供开箱即用的 MCP 服务器，无需复杂的配置
• 高精度数据：利用高德地图的权威天气数据，提供准确的天气信息
• MCP 原生支持：完全符合 MCP 协议规范，与 MCP Router 等工具无缝集成
• 灵活配置：支持多种天气查询方式，包括实时天气、预报和空气质量
• 易于部署：提供简单的安装和配置流程，支持多种部署方式

这个项目旨在为 MCP 生态系统提供一个可靠、易用的天气数据源，让开发者能够轻松地在 AI 应用中集成天气功能，无论是构建智能助手、自动化系统还是其他需要天气信息的应用。

简介#

AMap Weather MCP 是一个基于高德地图 API 的 MCP（Model Context Protocol）服务器，提供实时天气查询和城市代码搜索功能。通过 MCP 协议，可以让 AI 助手获取准确的天气信息。

TIP

需要高德地图 API 密钥才能使用，支持中国所有城市的天气查询

功能特性#

• 🌤️ 实时天气查询 - 支持按城市名称或城市代码查询天气信息
• 📍 城市搜索 - 支持精确匹配和模糊搜索中国所有城市
• 📊 4日天气预报 - 获取详细的天气预报数据
• 🔄 多种查询方式：
  • 按城市名称查询（如：杭州市、北京市）
  • 按行政代码（adcode）查询
  • 列出所有可用城市
  • 按 adcode 获取城市信息

系统需求#

• Python 3.8+
• 高德地图 API 密钥（申请教程）

安装#

1
git clone https://github.com/ChuranNeko/amap-weather-mcp.git
2
cd amap-weather-mcp

1
uv sync

1
pip install -r requirements.txt

配置#

1
{
2
    "mcpServers": {
3
        "amap-weather-mcp": {
4
            "name": "amap-weather-mcp",
5
            "type": "stdio",
6
            "isActive": true,
7
            "command": "uv",
8
            "args": [
9
                "--directory",
10
                "/path/to/amap-weather-mcp",
11
                "run",
12
                "main.py"
13
            ],
14
            "env": {
15
                "AMAP_API_KEY": "your-api-key-here"
16
            }
17
        }
18
    }
19
}

使用方式#

项目结构#

1
amap-weather-mcp/
2
├── main.py                 # 主程序文件
3
├── city_codes.json        # 城市代码数据库
4
├── requirements.txt       # 项目依赖
5
├── .gitignore            # Git 忽略规则
6
└── README.md             # 本文件

依赖包#

• httpx - 异步 HTTP 客户端
• requests - HTTP 库
• mcp - Model Context Protocol 实现

开发说明#

使用示例#

1
# 通过城市名称查询
2
result = await get_weather_by_city_name("杭州市")
3

4
# 通过城市代码查询
5
result = await get_weather_by_city_code("330100")

1
# 搜索包含"杭州"的城市
2
cities = await search_city("杭州")

常见问题#

Q: 如何获取高德地图 API 密钥？ A: 访问 高德开放平台 注册账号并创建应用获取 API Key。

Q: 支持哪些城市？ A: 支持中国所有地级市和县级市，数据包含在 city_codes.json 文件中。

Q: 天气数据多久更新一次？ A: 高德地图天气数据通常每小时更新一次，具体频率以高德地图为准。

许可证#

MIT License

支持#

如有问题或建议，欢迎提交 Issue 或 Pull Request。