先了解MCP 公开服务市场首先给大家推荐一个优质的 MCP 公开服务平台https://mcp.so/zh这个平台类似 MCP 服务的「GitHub」目前已收录超过一万八千个公开 MCP 服务涵盖地图、工具、接口等各类场景我们今天要用的高德地图 MCP 服务也收录其中。mcp-market高德地图 MCP 服务直达链接https://mcp.so/zh/server/amap-maps/amap进入链接后注意保存页面中的「服务器配置 JSON」如下所示后续配置项目时会直接用到重点留意 env 中的 AMAP_MAPS_API_KEY 字段。mcp-gaode二、前置准备申请高德 API-Key调用高德地图 MCP 服务需先获取个人 API-Key步骤如下3步搞定登录高德开放平台访问高德开放平台https://lbs.amap.com/ 注册一个用户完成认证后登录到后台创建一个应用gaode-project生成 API-Key注意服务平台选择Web服务填写完成后提交即可生成 API-Key保存好该 Key后续替换配置使用。gaode-api-key三、编写客户端代码连接高德服务前置准备完成后开始配置项目、编写代码全程分为3个步骤也很简单操作。拷贝高德MCP服务中的json文件到项目中**注意: **替换api_key使用我们刚刚创建好的api_key{“mcpServers”: {“amap-maps”: {“command”: “npx”,“args”: [“-y”,“amap/amap-maps-mcp-server”],“env”: {“AMAP_MAPS_API_KEY”: “api_key”}}}}把这个json放到项目resource目录下命名为 mcp-servers-config.json 可自定义但需与后续配置对应修改application.yml配置文件添加 MCP 客户端配置核心是指定上述 JSON 文件的路径spring:application:name: spring-ai-alibaba-agentai:dashscope:api-key: ${AliQwen_API}mcp:client:type: asyncrequest-timeout: 10stoolcallback:enabled: truestdio:servers-configuration: classpath:/mcp-servers-config.json3. 编写测试代码测试代码其实和上一篇的客户端代码基本没有什么改动我就简单放上来一些啦GetMapping(“mcpTest”)private void mcpTest() throws GraphRunnerException {ChatModel chatModel getChatModel(); ToolCallback[] toolCallbacks toolCallbackProvider.getToolCallbacks(); System.out.printf( Find the tools from spring ToolCallbackProvider %s , JSON.toJSONString(toolCallbacks)); // 构建智能体并绑定mcp服务 ReactAgent agent ReactAgent.builder() .name(ip_search) .model(chatModel) .description(你是一个天气查询助手) .saver(new MemorySaver()) .toolCallbackProviders(toolCallbackProvider) .build(); // 运行时配置 RunnableConfig config RunnableConfig.builder() .threadId(session) .build(); // 流式调用agent FluxNodeOutput stream agent.stream(上海未来天气怎么样, config); StringBuffer answerString new StringBuffer(); stream.doOnNext(output - { if (output.node().equals(_AGENT_MODEL_)) { answerString.append(((StreamingOutput?) output).message().getText()); } else if (output.node().equals(_AGENT_TOOL_)) { answerString.append(\nTool Call:).append(((ToolResponseMessage) ((StreamingOutput?) output).message()).getResponses().get(0)).append(\n); } }) .doOnComplete(() - System.out.println(answerString)) .doOnError(e - System.err.println(Stream Processing Error: e.getMessage())) .blockLast();}代码编写完成后启动项目访问接口http://localhost:8080/mcpTest即可测试高德 MCP 服务调用效果。四、效果演示首先可以看到我们已经加载到了高德MCP的服务列表gaode-map-tool-list接下来可以看到大模型输出了对未来7天天气的回答gaode-mcp-result五、总结以上就是「Spring AI Alibaba 调用 MCP 公开服务」的完整实操流程核心是「获取 API-Key → 配置 MCP 服务 → 编写测试代码」步骤简洁且可复现。