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

目录
相关文章
|
6天前
|
人工智能 JSON 监控
Claude Code 源码泄露:一份价值亿元的 AI 工程公开课
我以为顶级 AI 产品的护城河是模型。读完这 51.2 万行泄露的源码,我发现自己错了。
4302 17
|
16天前
|
人工智能 JSON 机器人
让龙虾成为你的“公众号分身” | 阿里云服务器玩Openclaw
本文带你零成本玩转OpenClaw:学生认证白嫖6个月阿里云服务器,手把手配置飞书机器人、接入免费/高性价比AI模型(NVIDIA/通义),并打造微信公众号“全自动分身”——实时抓热榜、AI选题拆解、一键发布草稿,5分钟完成热点→文章全流程!
14523 138
让龙虾成为你的“公众号分身” | 阿里云服务器玩Openclaw
|
5天前
|
人工智能 数据可视化 安全
王炸组合!阿里云 OpenClaw X 飞书 CLI,开启 Agent 基建狂潮!(附带免费使用6个月服务器)
本文详解如何用阿里云Lighthouse一键部署OpenClaw,结合飞书CLI等工具,让AI真正“动手”——自动群发、生成科研日报、整理知识库。核心理念:未来软件应为AI而生,CLI即AI的“手脚”,实现高效、安全、可控的智能自动化。
2894 8
王炸组合!阿里云 OpenClaw X 飞书 CLI,开启 Agent 基建狂潮!(附带免费使用6个月服务器)
|
6天前
|
人工智能 自然语言处理 数据挖掘
零基础30分钟搞定 Claude Code,这一步90%的人直接跳过了
本文直击Claude Code使用痛点,提供零基础30分钟上手指南:强调必须配置“工作上下文”(about-me.md+anti-ai-style.md)、采用Cowork/Code模式、建立标准文件结构、用提问式提示词驱动AI理解→规划→执行。附可复制模板与真实项目启动法,助你将Claude从聊天工具升级为高效执行系统。
|
6天前
|
人工智能 定位技术
Claude Code源码泄露:8大隐藏功能曝光
2026年3月,Anthropic因配置失误致Claude Code超51万行源码泄露,意外促成“被动开源”。代码中藏有8大未发布功能,揭示其向“超级智能体”演进的完整蓝图,引发AI编程领域震动。(239字)
2444 9

热门文章

最新文章