项目简介

该项目是一个非官方的高德地图 Model Context Protocol (MCP) 服务器实现。它通过 MCP 协议将高德地图开放平台提供的能力（如天气查询）暴露给支持 MCP 的大型语言模型 (LLM) 客户端，如 Cursor、Claude Desktop、Cline 等，使得LLM能够利用真实世界的地理信息。

主要功能点

• 提供基于高德地图API的天气查询能力。
• 注册并执行作为MCP工具暴露给LLM客户端的天气查询功能。
• 通过标准的MCP协议与客户端通信。

安装步骤

1. 确保您已安装 Python 3.10 或更高版本。
2. 安装 Python 包管理器 'uv'。可以通过 pip 安装：'pip install uv'。
3. 在高德开放平台申请您的应用 Key (AMAP_KEY)。

服务器配置（供 MCP 客户端使用）

该 MCP 服务器通常由 MCP 客户端按需启动。您需要在 MCP 客户端的配置中添加以下信息来连接此服务器：

• 服务器名称: 可以自定义，例如 "AMap"。
• 启动命令 (command): 'uvx' (这会使用 uv 自动管理并运行项目)。
• 命令参数 (args): '["amap-mcp"]' (指定要运行的 Python 包入口点)。
• 环境变量 (env): '{ "AMAP_KEY": "<替换为你的高德地图Key>" }' (将您申请的高德地图 Key 配置为环境变量，供服务器使用)。

具体的配置格式请参考您使用的 MCP 客户端的文档。

基本使用方法

配置完成后，在支持的 MCP 客户端中，当LLM需要查询某个城市的天气时，它可以识别并调用此 MCP 服务器提供的天气查询工具。您只需在与LLM的对话中提及需要查询天气的城市，LLM便可能自动触发该工具并获取实时天气信息。