Python 使用 MCP 客户端调用高德地图服务查询天气

MCP 官网

• https://modelcontextprotocol.io/introduction

官方 MCP 服务示例

• https://github.com/modelcontextprotocol/servers

GitHub SDK

• python-sdk：https://github.com/modelcontextprotocol/python-sdk
• java-sdk：https://github.com/modelcontextprotocol/java-sdk
• typescript-sdk：https://github.com/modelcontextprotocol/typescript-sdk

简介

MCP 是一种开放协议，它标准化了应用程序向 LLM 提供上下文的方式。可以将 MCP 视为 AI 应用程序的 USB-C 端口。正如 USB-C 提供了一种将设备连接到各种外围设备和配件的标准化方式一样，MCP 提供了一种将 AI 模型连接到不同数据源和工具的标准化方式。

架构

• MCP 主机：希望通过 MCP 访问数据的程序，例如 Claude Desktop、IDE 或 AI 工具
• MCP 客户端：与服务器保持 1:1 连接的协议客户端
• MCP 服务器：轻量级程序，每个程序都通过标准化模型上下文协议公开特定功能
• 本地数据源：MCP 服务器可以安全访问的您的计算机文件、数据库和服务
• 远程服务：MCP 服务器可通过互联网（例如通过 API）连接到的外部系统

高德地图 MCP 客户端示例

注：Node 版本 >= 18.20.4，版本太低无法执行 npx 命令。

Python SDK 客户端

import asyncio
from mcp import ClientSession, StdioServerParameters
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"}
)

async def run():
    async  stdio_client(server_params)  (read, write):
          ClientSession(read, write)  session:
             session.initialize()
            tools =  session.list_tools()
            (, tools)
            result =  session.call_tool(, arguments={: })
            (, result)

 __name__ == :
    asyncio.run(run())