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

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

MCP 是一种开放协议,用于标准化应用程序向 LLM 提供上下文的方式。内容涵盖 MCP 基本架构,包括主机、客户端、服务器及数据源。重点展示如何使用 Python SDK 和 Node.js 环境配置高德地图 MCP 服务器,通过代码示例演示调用天气查询工具。同时提供 Java SDK 的实现方案,帮助开发者快速集成地图服务到 AI 应用中。

CoderByte发布于 2026/2/8更新于 2026/5/301.8K 浏览
Python 实现 MCP 客户端调用高德地图天气查询示例

MCP 简介

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

架构

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

官方资源

  • MCP 官网
  • MCP 官方文档中文版
  • 官方 MCP 服务示例 (GitHub)
  • Python SDK (GitHub)
  • Java SDK (GitHub)

高德地图 MCP 客户端示例

环境准备

  • Node 下载:https://nodejs.org/zh-cn/download

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

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

高德地图 MCP 服务 tools 列表示例:

{
  "tools": [
    {
      "description": "根据城市名称或者标准 adcode 查询指定城市的天气",
      "inputSchema": {
        "properties"     
         
         
      
       
    
  

:
{
"city"
:
{
"type"
:
"string"
,
"description"
:
"城市名称或者 adcode"
}
}
,
"required"
:
[
"city"
]
,
"type"
:
"object"
}
,
"name"
:
"maps_weather"
}
]
}

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

Maven 依赖:

<!-- https://mvnrepository.com/artifact/io.modelcontextprotocol.sdk/mcp -->
<dependency>
    <groupId>io.modelcontextprotocol.sdk</groupId>
    <artifactId>mcp</artifactId>
    <version>0.8.1</version>
</dependency>

Gradle 依赖:

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. 架构
  3. 官方资源
  4. 高德地图 MCP 客户端示例
  5. 环境准备
  6. Python SDK 客户端
  7. Java SDK 客户端
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • 2026 年 3 月 15 日 AI 深度早报:GTC 开幕与具身智能突破
  • nlohmann/json 详解:现代 C++ 的 JSON 处理方案
  • Rockchip Ubuntu24.04 移植 AIC8800 驱动并开启 AP 模式
  • FPGA 实现 MIPI 协议全解析与完整时序规范
  • Qt与Web混合编程:CEF与QCefView深度解析
  • Claude Code 持久化记忆插件 claude-mem 完全指南
  • FPGA 与 IC 职业前景对比及选择指南
  • whisper.cpp ggml-large-v3.bin 模型参数文件下载
  • Rust 使用 Slint 库开发 UI 界面工程搭建教程
  • OpenClaw 原理详解:自托管 AI 网关架构深度剖析
  • Perplexica:Perplexity 的开源替代方案
  • CosyVoice3 英文发音不准?用 ARPAbet 音素标注提升精度
  • Hibernate 集合映射
  • WhisperLiveKit 实时语音识别指南:从安装到生产部署
  • 链表实战:LeetCode Hot 100 经典题目深度解析
  • VS Code + WSL 下 GitHub 访问不稳定及 Copilot 卡顿解决方案
  • Python 分布式追踪实战:SkyWalking 埋点接入指南
  • Windows 环境下 faster-whisper 部署:CUDA 加速与 PyAV 依赖配置
  • Stable Diffusion 绘画实战:云端部署与提示词技巧
  • ComfyUI Photoshop 插件安装及 AI 绘画工作流指南

相关免费在线工具

  • 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