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

关键点说明：

• 这里使用了 StdioServerParameters 来启动 npx 进程，这是 MCP 服务端的标准启动方式。
• call_tool 是核心方法，第一个参数是工具名，第二个是入参字典。
• 异步编程模式 (async/await) 是必须的，因为底层 IO 是非阻塞的。

Java SDK 参考

如果你偏好 Java 生态，也可以参考以下同步客户端的实现方式。注意 Maven 依赖版本需匹配。

依赖配置

<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;
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());
    }
}

官方资源

• MCP 官网: https://modelcontextprotocol.io/introduction
• GitHub SDK: https://github.com/modelcontextprotocol/python-sdk
• Java SDK 迁移指南: https://github.com/modelcontextprotocol/java-sdk/blob/main/migration-0.8.0.md