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

关键点说明：

1. 使用 StdioServerParameters 指定启动 npx 命令来运行高德的服务容器。
2. env 字典中必须注入 AMAP_MAPS_API_KEY，否则服务无法请求外部数据。
3. 整个流程是异步的，需要配合 asyncio 使用。

Java SDK 客户端实现

对于 Java 开发者，官方也提供了对应的 SDK。注意从 0.7 版本迁移到 0.8 版本时 API 有所变化，建议参考官方迁移指南。

依赖引入

<dependency>
    <groupId>io.modelcontextprotocol.sdk</groupId>
    <artifactId>mcp</artifactId>
    <version>0.8.1</version>
</dependency>

代码示例

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;

public class JunitTest {
    public void test() {
        // 构建传输参数
        ServerParameters params = ServerParameters.builder("npx")
            .args("-y", "@amap/amap-maps-mcp-server")
            .addEnvVar("AMAP_MAPS_API_KEY", "你的 API_KEY")
            .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 官网
• GitHub - Python SDK
• GitHub - Java SDK
• GitHub - Servers 示例