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

运行这段代码后，你会看到服务端暴露的工具列表，随后打印出福州的天气信息。这里的关键是 call_tool 方法，它接收工具名称和参数字典，异步返回结果。

Java 客户端实现

如果你更习惯使用 Java，也可以利用官方的 Java SDK。Maven 依赖如下：

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

在代码中，我们需要构建 ServerParameters 并创建同步客户端。注意，虽然 Python 示例使用了异步，但 Java SDK 提供了同步接口，简化了测试流程。

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", "your_api_key_here")
            .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，核心思路都是相同的：配置服务器参数，建立连接，然后调用工具。这种标准化的方式大大降低了集成的复杂度。