Python 实现 MCP 客户端调用高德地图天气查询示例
MCP（Model Context Protocol）是一种开放协议，它标准化了应用程序向 LLM 提供上下文的方式。你可以把它理解为 AI 应用的 USB-C 端口：就像 USB-C 统一了设备连接方式一样，MCP 让 AI 模型能标准化地接入各种数据源和工具。
架构概览
在理解代码之前，先简单梳理一下核心组件：
- MCP 主机：希望访问数据的程序，比如 Claude Desktop、IDE 或 AI 工具。
- MCP 客户端：与服务器保持 1:1 连接的协议客户端。
- MCP 服务器：轻量级程序，通过标准协议公开特定功能。
- 数据源：包括本地文件、数据库以及远程 API 服务。
环境准备
运行高德地图 MCP 服务需要 Node.js 环境。请确保你的 Node 版本不低于 18.20.4，否则 npx 命令可能无法正常工作。
你需要先申请高德地图的 AMAP_MAPS_API_KEY，后续配置中会用到。
Python SDK 实现
这是最直接的集成方式。首先安装依赖：
pip install mcp
接下来是核心代码。这段脚本展示了如何启动一个异步会话，初始化连接，并调用高德提供的天气查询工具。
import asyncio
from mcp import ClientSession, StdioServerParameters, types
from mcp.client.stdio import stdio_client
# 配置服务器参数
server_params = StdioServerParameters(
command="npx",
args=["-y", "@amap/amap-maps-mcp-server"],
env={"AMAP_MAPS_API_KEY": "你的 API_KEY_占位符"}
)
async def run():
# 建立stdio通信通道
async with stdio_client(server_params) as (read, write):
async with ClientSession(read, write) as session:
await session.initialize()
# 列出可用工具
tools = await session.list_tools()
print("工具列表:", tools)
result = session.call_tool(
,
arguments={: }
)
(, result)
__name__ == :
asyncio.run(run())
