Spring AI Alibaba + MCP:调用MCP市场公开服务实操

简介: 本文详细讲解Spring Ai Alibaba调用MCP市场公开服务的全流程,以高德地图MCP服务为例,包含API-Key申请、客户端配置、代码实操,助力开发者快速掌握Spring Ai Alibaba与MCP服务对接技巧。

上一篇博客,我们介绍了如何将本地工具封装为 MCP 服务,并成功创建客户端实现连接,感兴趣的朋友可以回顾:https://www.lucaju.cn/index.php/archives/169/

今天,我们聚焦实操——如何调用 MCP 市场上的公开服务,以「高德地图 MCP 服务」为例,步骤清晰可复现,新手也能快速上手。

一、先了解:MCP 公开服务市场

首先给大家推荐一个优质的 MCP 公开服务平台:https://mcp.so/zh

这个平台类似 MCP 服务的「GitHub」,目前已收录超过一万八千个公开 MCP 服务,涵盖地图、工具、接口等各类场景,我们今天要用的高德地图 MCP 服务也收录其中。

mcp-market.png

高德地图 MCP 服务直达链接:https://mcp.so/zh/server/amap-maps/amap

进入链接后,注意保存页面中的「服务器配置 JSON」(如下所示),后续配置项目时会直接用到,重点留意 env 中的 AMAP_MAPS_API_KEY 字段。

image-20260319155446199

二、前置准备:申请高德 API-Key

调用高德地图 MCP 服务,需先获取个人 API-Key,步骤如下(3步搞定):

1. 登录高德开放平台

访问高德开放平台:https://lbs.amap.com/ ,注册一个用户,完成认证后登录到后台

2. 创建一个应用

gaode-project.png

3. 生成 API-Key

注意:服务平台选择Web服务,填写完成后提交,即可生成 API-Key,保存好该 Key,后续替换配置使用。

gaode-api-key.png

三、编写客户端代码连接高德服务

前置准备完成后,开始配置项目、编写代码,全程分为3个步骤,也很简单操作。

1. 拷贝高德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 (可自定义,但需与后续配置对应)

2. 修改application.yml配置文件

添加 MCP 客户端配置,核心是指定上述 JSON 文件的路径

spring:
  application:
    name: spring-ai-alibaba-agent
  ai:
    dashscope:
      api-key: ${
   AliQwen_API}
    mcp:
      client:
        type: async
        request-timeout: 10s
        toolcallback:
          enabled: true
        stdio:
          servers-configuration: classpath:/mcp-servers-config.json

3. 编写测试代码

测试代码其实和上一篇的客户端代码基本没有什么改动,我就简单放上来一些啦~

@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
    Flux<NodeOutput> 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.png

接下来可以看到大模型输出了对未来7天天气的回答

gaode-mcp-result.png

五、总结

以上就是「Spring AI Alibaba 调用 MCP 公开服务」的完整实操流程,核心是「获取 API-Key → 配置 MCP 服务 → 编写测试代码」,步骤简洁且可复现。

本次实操的全部代码(含之前 Agent 相关测试代码)已上传至 GitHub,需要的朋友可以自行获取,如有疑问,欢迎在评论区交流~

GitHub 链接:https://github.com/Jucunqi/spring-ai-alibaba-agent.git

目录
相关文章
|
29天前
|
存储 人工智能 Java
吃透 Spring AI Alibaba 多智能体|四大协同模式+完整代码
本文详细讲解 Spring AI Alibaba Multi-Agent 多智能体架构,包含顺序执行、并行执行、LLM 路由、监督者四大协同模式,搭配可运行代码示例与真实业务场景,从零带你上手多智能体开发。
940 3
|
1月前
|
JSON API PHP
使用PHP对接美股股票市场API 实时数据、IPO和K线(Kline)的PHP对接方案
StockTV API 面向开发者,提供美股实时行情、历史K线(5分钟至1月)、IPO日历等数据,支持HTTP/WS双接入,全接口返回标准JSON,含纽交所(ex=1)与纳斯达克(ex=2)标识。(239字)
|
19天前
|
人工智能 Java 定位技术
【SpringAIAlibaba新手村系列】(16)调用百度 MCP 服务
本章展示如何在客户端接入第三方百度 MCP 服务。通过 spring-ai-starter-mcp-client、application.yml 与 mcp-server.json5 完成 stdio 方式连接,自动发现并注册远端工具到 ChatClient,实现天气、IP 归属地、路线规划等能力调用。
287 9
|
19天前
|
人工智能 JSON 编解码
【SpringAIAlibaba新手村系列】(15)MCP Client 调用本地服务
本章从 MCP Client 视角说明如何连接上一章提供的本地服务,并把远端工具接入 ChatClient。重点讲解 Streamable-HTTP 配置、ToolCallbackProvider 的注入方式,以及模型如何通过 JSON-RPC 消息完成工具调用与结果回传。
256 21
|
22天前
|
存储 人工智能 Java
告别 AI 对话 “失忆”!Spring AI 聊天记忆底层原理与全场景落地实战
Spring AI提供优雅的聊天记忆解决方案,彻底解决大模型“失忆”痛点。其分层架构支持内存/MySQL等多存储,通过ChatMemory、ChatMemoryRepository和ChatMemoryAdvisor三大组件,实现会话隔离、消息有序、窗口可控,开箱即用,低侵入、高扩展。
414 13
告别 AI 对话 “失忆”!Spring AI 聊天记忆底层原理与全场景落地实战
|
21天前
|
人工智能 测试技术 Apache
Gemma 4 开源发布: Google 迄今最强开放模型,主打推理与 Agent 能力
Google正式开源Gemma 4系列(Apache 2.0许可),含E2B/E4B(端侧多模态)、26B MoE与31B Dense四款模型。参数效率卓越:31B位列开放模型榜第3,26B第6;边缘模型支持128K上下文、原生音视频处理,单卡/手机均可高效运行。
934 12
Gemma 4 开源发布: Google 迄今最强开放模型,主打推理与 Agent 能力
|
人工智能 JavaScript Java
【SpringAIAlibaba新手村系列】(1)初识 Spring AI Alibaba 框架
本文介绍了SpringAIAlibaba框架的基本概念和使用方法。作为Spring官方AI框架的阿里云实现版本,它简化了Java开发者调用AI模型的过程。文章详细讲解了核心概念如ChatModel、ChatClient,以及阿里云百炼平台的功能。通过HelloWorld项目示例,展示了如何配置APIKey、编写控制层代码,实现普通调用和流式输出两种AI交互方式。重点阐述了SpringAI与SpringAIAlibaba的关系,以及自动配置机制的工作原理,帮助开发者快速上手这一框架。
2179 4

热门文章

最新文章