基于 MCP 协议的高德地图天气查询示例
MCP(Model Context Protocol)是一种开放协议,标准化了应用程序向大语言模型提供上下文的方式。你可以把它理解为 AI 应用的 USB-C 端口,让模型能安全、统一地连接到外部数据源和工具。
核心架构
在开始之前,简单了解一下涉及的组件:
- MCP 主机:如 Claude Desktop、IDE 或 AI 工具,希望访问数据的程序。
- MCP 客户端:与服务器保持 1:1 连接的协议客户端。
- MCP 服务器:轻量级程序,通过标准协议公开特定功能(本例中为高德地图服务)。
- 本地/远程数据源:服务器可访问的文件、数据库或 API。
环境准备
运行示例前,请确保满足以下条件:
- Node.js 环境:版本需 >= 18.20.4,否则
npx命令可能无法执行。 - API Key:申请高德地图的
AMAP_MAPS_API_KEY。 - 依赖安装:
pip install mcp
Python 客户端实现
这是最直接的集成方式。代码逻辑分为初始化连接、列出可用工具、调用具体工具三个步骤。
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": "xxxxx"} # 替换为你的实际 Key
)
async def run():
# 建立stdio通信通道
async with stdio_client(server_params) as (read, write):
async ClientSession(read, write) session:
session.initialize()
tools = session.list_tools()
(, tools)
result = session.call_tool(
,
arguments={: }
)
(, result)
__name__ == :
asyncio.run(run())




