跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonNode.jsAIjava

Python 实现 MCP 客户端调用高德地图天气查询示例

综述由AI生成MCP 是一种开放协议,标准化了应用程序向 LLM 提供上下文的方式。如何使用 Python SDK 连接高德地图 MCP 服务器,通过调用 maps_weather 工具查询指定城市的天气信息。示例涵盖了环境配置、依赖安装及核心代码逻辑,同时提供了 Java SDK 的实现参考,帮助开发者快速集成外部数据源至 AI 应用。

岁月神偷发布于 2026/2/6更新于 2026/5/2921 浏览
Python 实现 MCP 客户端调用高德地图天气查询示例

MCP 官网

  • https://modelcontextprotocol.io/introduction

MCP 官方文档中文版

  • https://app.apifox.com/project/5991953

官方 MCP 服务示例

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

Github

  • 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 下载:https://nodejs.org/zh-cn/download

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

  • 高德 MCP 服务 tools 列表

高德地图文档(申请 AMAP_MAPS_API_KEY):https://lbs.amap.com/api/mcp-server/summary

{"tools":[{"description"...
:
"根据城市名称或者标准 adcode 查询指定城市的天气"
,
"inputSchema"
:
{
"properties"
:
{
"city"
:
{
"type"
:
"string"
,
"description"
:
"城市名称或者 adcode"
}
}
,
"required"
:
[
"city"
]
,
"type"
:
"object"
}
,
"name"
:
"maps_weather"
}
,
{
"description"
:
"查询关键词搜或者周边搜获取到的 POI ID 的详细信息"
,
"inputSchema"
:
{
"properties"
:
{
"id"
:
{
"type"
:
"string"
,
"description"
:
"关键词搜或者周边搜获取到的 POI ID"
}
}
,
"required"
:
[
"id"
]
,
"type"
:
"object"
}
,
"name"
:
"maps_search_detail"
}
,
]
}

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": "xxxxx"}
)

async def run():
    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 = await session.call_tool("maps_weather", arguments={"city": "福州"})
            print("调用结果:", result)

if __name__ == "__main__":
    asyncio.run(run())

java-sdk 客户端

  • 0.7 版本迁移 0.8 版指南:https://github.com/modelcontextprotocol/java-sdk/blob/main/migration-0.8.0.md
<!-- https://mvnrepository.com/artifact/io.modelcontextprotocol.sdk/mcp -->
<dependency>
    <groupId>io.modelcontextprotocol.sdk</groupId>
    <artifactId>mcp</artifactId>
    <version>0.8.1</version>
</dependency>
implementation("io.modelcontextprotocol.sdk:mcp:0.8.1") 
import io.modelcontextprotocol.client.McpClient;
import io.modelcontextprotocol.client.McpSyncClient;
import io.modelcontextprotocol.client.transport.ServerParameters;
import io.modelcontextprotocol.client.transport.StdioClientTransport;
import io.modelcontextprotocol.spec.McpSchema;
import org.junit.jupiter.api.Test;
import java.util.Map;

public class JunitTest {
    @Test
    public void test() {
        ServerParameters params = ServerParameters.builder("npx")
                .args("-y", "@amap/amap-maps-mcp-server")
                .addEnvVar("AMAP_MAPS_API_KEY", "xxxxx")
                .build();
        StdioClientTransport transport = new StdioClientTransport(params);
        McpSyncClient client = McpClient.sync(transport).build();
        client.initialize();
        McpSchema.ListToolsResult toolsList = client.listTools();
        System.out.println("工具列表:" + toolsList);
        McpSchema.CallToolResult mapsWeather = client.callTool(new McpSchema.CallToolRequest("maps_weather", Map.of("city", "福州")));
        System.out.println("调用结果:" + mapsWeather.content());
    }
}

目录

  1. MCP 官网
  2. MCP 官方文档中文版
  3. 官方 MCP 服务示例
  4. Github
  5. 简介
  6. 架构
  7. 高德地图 MCP 客户端示例
  8. python-sdk 客户端
  9. java-sdk 客户端
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • AI 大模型岗位面试指南与核心学习路径解析
  • 前端常用动画库实战指南:GSAP、Lottie、Swiper 与 AOS
  • 2026 年各大高校 AIGC 检测政策汇总
  • Flutter WebView 在 iOS 18 上点击失效的原因与临时方案
  • FPGA 入门:Vivado/Vitis 2023.1 软件安装指南
  • Xilinx FPGA 温度等级详解与选型策略
  • CCF-GESP 2025 年 12 月三级 C++ T1 密码强度检测
  • Windows11 VMware 17.6.0 更新 Tools 报错无法连接服务器解决方案
  • LangChain 大模型应用开发入门指南
  • 使用 Trae IDE 将 Figma 设计稿转化为前端代码
  • AI 印象派艺术工坊与 Stable Diffusion 对比:轻量部署案例评测
  • Vivado 连接 JTAG 烧录 FPGA 实战指南
  • DeepSeek-R1-Distill-Llama-8B 模型写作能力实测与性能分析
  • 基于 LangGraph 的金融智能体架构:RAG 重排序与代码解释器实践
  • 深入解析 Stable Diffusion 基石:潜在扩散模型(LDMs)
  • OpenClaw 接入飞书机器人并集成 Ollama 本地大模型实战
  • OpenClaw 全平台卸载指南:Windows、macOS、Linux 及包管理器清理
  • AI 技能 UI UX Pro Max 驱动的现代前端 UI 工作流
  • MC.JS WEBMC1.8 实战:构建在线多人沙盒游戏
  • 贪心算法核心解析:局部最优策略与经典应用实践

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online