Python 调用高德地图 MCP 服务查询天气实战

实际运行时，如果网络不通或 Key 无效，会抛出异常。调试时建议先打印 tools 列表确认服务已就绪。

Java SDK 客户端实现

如果你习惯使用 Java，也可以利用官方提供的 SDK。目前推荐迁移至 0.8 版本，兼容性更好。

Maven 依赖

在 pom.xml 中添加以下依赖：

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

代码示例

Java 端同样需要构建 ServerParameters 并初始化同步客户端。逻辑与 Python 类似，只是语法差异较大。

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", "你的 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 连接。无论是 Python 还是 Java，核心流程都是：初始化传输层 -> 建立会话 -> 列出工具 -> 调用工具。这种方式极大地降低了集成外部 API 的复杂度，让 AI 应用能更灵活地获取实时数据。