Python 调用高德地图 MCP 服务查询天气示例

代码逻辑很清晰：初始化会话后，先获取工具列表确认连接正常，然后调用 maps_weather 接口传入城市参数。实际运行时，你会看到控制台输出包含天气详情的 JSON 数据。

Java 客户端实现

如果你更习惯 Java 生态，也可以参考官方提供的同步客户端实现。需要先在 pom.xml 中添加依赖：

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

核心代码逻辑与 Python 类似，主要区别在于使用了同步阻塞的 McpSyncClient：

import io.modelcontextprotocol.client.McpClient;
import io.modelcontextprotocol.client.transport.ServerParameters;
import io.modelcontextprotocol.client.transport.StdioClientTransport;
import io.modelcontextprotocol.spec.McpSchema;

public class JunitTest {
    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());
    }
}

总结

通过上述示例，你可以快速将高德地图的天气查询能力接入到支持 MCP 协议的 AI 应用中。无论是 Python 还是 Java，核心流程都是建立连接、初始化会话、调用工具。注意在实际部署时妥善保管 API Key，避免硬编码在代码中。