<h1 id="OJIgB">一、MCP简介</h1>

![](https://developer.qcloudimg.com/http-save/yehe-5673264/fccb51f23158666ba0af39ab6db48b8a.png)

> MCP 是一种开放协议，它标准化了应用程序如何向大模型提供上下文的方式。可以将 MCP 想象成 AI 应用的 USB 接口。就像 USB 为设备连接各种外设和配件提供了标准化方式一样，MCP 为 AI 模型连接不同的数据源和工具提供了标准化的方法。
>
> 作用：
>
> 轻松增强 AI 的能力、
>
> 统一标准，降低使用和理解成本
>
> 打造服务生态，造福广大开发者
>
> 理解：例如Maven一样，java定义了规范，开发者按照规范开发，使用者需要用什么功能就引用什么jar包
>
> MCP官网：[https://modelcontextprotocol.io/](https://modelcontextprotocol.io/)
>
> 常用的MCP应用网站：
>
> [https://mcp.so/](https://mcp.so/)
>

1. 架构：

![](https://developer.qcloudimg.com/http-save/yehe-5673264/49a18e119c89c264736fa55de3ac7359.png)

2. 客户端和服务端建立通信流程

![](https://developer.qcloudimg.com/http-save/yehe-5673264/63dfb1ec237c2bb95d992fc57bd835b3.png)

<h3 id="uYt0f">MCP客户端</h3>
> 主要负责和 MCP‌ 服务器建立连接并进行通信二、集成Spring AI MCP 客户端
>



> 官网文档地址：[https://docs.spring.io/spring-ai/reference/api/mcp/mcp-client-boot-starter-docs.html](https://docs.spring.io/spring-ai/reference/api/mcp/mcp-client-boot-starter-docs.html)
>

1. 导入依赖

```xml

        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-mcp-client-spring-boot-starter</artifactId>
            <version>1.0.0-M6</version>
        </dependency>
```

2. 配置Json

```json
# 特别注意：在 Windows 环境下，命令配置需要添加 .cmd 后缀（如 npx.cmd），否则会报找不到命令的错误。
{
  "mcpServers": {
    "amap-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@amap/amap-maps-mcp-server"
      ],
      "env": {
        "AMAP_MAPS_API_KEY": "高德地图申请的apikey"
      }
    }
  }
}
```

3. 编写配置类

```yaml
spring:
  ai:
    mcp:
      client:
        stdio:
          servers-configuration: classpath:mcp-servers.json # 加载json文件
```

4. 集成代码

```java
 @Resource
    private ToolCallbackProvider toolCallbackProvider;

    /**
     * 客户端调用MCP服务
     * @param content
     * @param chatId
     * @return
     */

    public String getMessagewithMCPClient(String content,String chatId) {
        ChatResponse chatResponse = this.chatClient.prompt()
                .user(content)
                .tools(toolCallbackProvider)
                .advisors(advisor -> advisor.param("chat_memory_conversation_id", chatId)
                        .param("chat_memory_response_size", 10)).call().chatResponse();
        String text = chatResponse.getResult().getOutput().getText();
        log.info("text:{}", text);
        return text;
    }
```

5. 测试

```java
 @Test
    void getMessagewithMCPClient() {
        String messagewithMCPClient = ialdaApp.getMessagewithMCPClient("我的学校是三明学院，给我推荐10公里内可以舍友聚餐的地方", UUID.randomUUID().toString());
        Assertions.assertNotNull(messagewithMCPClient);
    }

```

6. 效果

![](https://developer.qcloudimg.com/http-save/yehe-5673264/ca7da7c8fb50939ddbdedbe64f8a4f66.png)



<h3 id="G6axS">MCP服务端</h3>

> 主要用来‎为客户端提供各种工‌具、资源和功能支持。
>



<h3 id="iLUOP">MCP使用方式：</h3>

> 云平台：云百炼平台有示例
>
> 客户端：cursor设置可以加入MCP，在对话时，需要时会调用MCP
>
> ![](https://developer.qcloudimg.com/http-save/yehe-5673264/92429e048f9a3ecae18a5ac9035be702.png)
>
> 程序使用：程序员自己实现
>



<h1 id="BS2HP">三、MCP服务端开发实战-图片搜索服务（Stdio版本）</h1>

> 免费获取图片API地址：[https://www.pexels.com/zh-cn](https://www.pexels.com/zh-cn)
>
> api文档：[https://www.pexels.com/api/documentation/#photos-search](https://www.pexels.com/api/documentation/#photos-search)
>
> 主要：虽然说是免费的，但是还是需要登录获得到APIkey
>

1. 新建一个模块：varin-image-search-mcp
2. 导入依赖：

```xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.4.10</version>
        <relativePath/> 
    </parent>
    <groupId>cn.varin</groupId>
    <artifactId>varin-image-search-mcp</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>varin-image-search-mcp</name>
    <description>varin-image-search-mcp</description>
    <url/>
    <licenses>
        <license/>
    </licenses>
    <developers>
        <developer/>
    </developers>
    <scm>
        <connection/>
        <developerConnection/>
        <tag/>
        <url/>
    </scm>
    <properties>
        <java.version>21</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>


        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-mcp-server-webmvc-spring-boot-starter</artifactId>
            <version>1.0.0-M6</version>
        </dependency>
        <dependency>
            <groupId>cn.hutool</groupId>
            <artifactId>hutool-all</artifactId>
            <version>5.8.38</version>
        </dependency>

    </dependencies>

   

</project>

```

3. 配置类：

```yaml
spring:
  application:
    name: varin-image-search-mcp
  profiles:
    active: stdio
server:
  port: 9977
```

```yaml
spring:
  ai:
    mcp:
      server:
        name: varin-image-search-mcp-server
        version: 0.0.1
        type: SYNC # 同步

        stdio: true

  main:
    web-application-type: none  #不启动wb服务
    banner-mode: off #关闭banner信息

imageSearch:
  api_key: 图片查询的apikey
```



4. 编写响应解析类

```java
package cn.varin.varinimagesearchmcp.entity;

import lombok.Data;

@Data
public class ImageSource {
    private String original;
    private String large2x;
    private String large;
    private String medium;
    private String small;
    private String portrait;
    private String landscape;
    private String tiny;
}

```

```java
package cn.varin.varinimagesearchmcp.entity;

import lombok.Data;

@Data
public class PexelsImage {
    private int id;
    private int width;
    private int height;
    private String url;
    private String photographer;
    private String photographerUrl;
    private int photographerId;
    private String avgColor;
    private ImageSource src;
    private boolean liked;
    private String alt;
}

```

```java
package cn.varin.varinimagesearchmcp.entity;

import lombok.Data;
import java.util.List;

@Data
public class PexelsResponse {
    private int totalResults;
    private int page;
    private int perPage;
    private List<PexelsImage> photos;
    private String nextPage;
}

```

5. 编写工具类

```java
package cn.varin.varinimagesearchmcp.tool;

import cn.varin.varinimagesearchmcp.entity.PexelsImage;
import cn.varin.varinimagesearchmcp.entity.PexelsResponse;
import org.springframework.ai.tool.annotation.Tool;
import org.springframework.ai.tool.annotation.ToolParam;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
import cn.hutool.http.HttpUtil;
import cn.hutool.json.JSONUtil;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

@Component
public class PexelsImageSearchTool {

    @Value("${imageSearch.api_key}")
    private String apiKey;

    private static final String PEXELS_SEARCH_URL = "https://api.pexels.com/v1/search";
    private static final int DEFAULT_PER_PAGE = 5; // 默认返回5张图片

    @Tool( description = "根据图片类型查询到对应类型的图片")
    public String searchImages( @ToolParam(description = "图片的类型") String type) {
        // 设置请求头
        Map<String, String> headers = new HashMap<>();
        headers.put("Authorization", apiKey);

        // 设置请求参数
        Map<String, Object> params = new HashMap<>();
        params.put("query", type);
        params.put("per_page", DEFAULT_PER_PAGE);

        // 发送GET请求
        String result = HttpUtil.createGet(PEXELS_SEARCH_URL)
        .addHeaders(headers)
        .form(params)
        .execute()
        .body();

        // 解析JSON响应
        PexelsResponse response = JSONUtil.toBean(result, PexelsResponse.class);
        StringBuffer stringBuffer = new StringBuffer();
        // 返回图片列表
        response.getPhotos().forEach(pexelsImage -> {
            String original = pexelsImage.getSrc().getOriginal();
            stringBuffer.append(original+"\n");

        });
        return stringBuffer.toString();
    }
}
```



6. 测试工具类

```java
package cn.varin.varinimagesearchmcp.tool;

import cn.varin.varinimagesearchmcp.entity.PexelsImage;
import jakarta.annotation.Resource;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;

import java.util.List;

import static org.junit.jupiter.api.Assertions.*;

@SpringBootTest
class PexelsImageSearchToolTest {
    @Resource
    private PexelsImageSearchTool pexelsImageSearchTool;

    @Test
    void searchImages() {
        String s = pexelsImageSearchTool.searchImages("computer");
        assertNotNull(s);
    }

```

结果：

```json
https://images.pexels.com/photos/577585/pexels-photo-577585.jpeg
https://images.pexels.com/photos/1714208/pexels-photo-1714208.jpeg
https://images.pexels.com/photos/792199/pexels-photo-792199.jpeg
https://images.pexels.com/photos/2265488/pexels-photo-2265488.jpeg
https://images.pexels.com/photos/1779487/pexels-photo-1779487.jpeg

```

7. 通过MethodToolCallbackProvider将工具类转成：ToolCallbackProvider类并注入到Bean中


```java
package cn.varin.varinimagesearchmcp;

import cn.varin.varinimagesearchmcp.tool.PexelsImageSearchTool;
import org.springframework.ai.tool.ToolCallbackProvider;
import org.springframework.ai.tool.method.MethodToolCallbackProvider;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;

@SpringBootApplication
public class VarinImageSearchMcpApplication {

    public static void main(String[] args) {
        SpringApplication.run(VarinImageSearchMcpApplication.class, args);
    }

    /**
     * 将tool对象转成MCP
     * @param pexelsImageSearchTool
     * @return
     */
    @Bean
    public ToolCallbackProvider toolCallbackProvider(PexelsImageSearchTool pexelsImageSearchTool) {
        return MethodToolCallbackProvider.builder()
        .toolObjects(pexelsImageSearchTool)
        .build();
    }
}
```



8. 打包

![](https://developer.qcloudimg.com/http-save/yehe-5673264/149ad0c8716893832a27eb5e564efbd6.png)

9. 本地客户端测试

> 在原来的mcp-service.json文件中添加自己生成的mcp就可以了，
>

```json
{
  "mcpServers": {
    "amap-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@amap/amap-maps-mcp-server"
      ],
      "env": {
        "AMAP_MAPS_API_KEY": "18ccd882771656f282c57c650fe16a63"
      }
    },
    # 新的
    "varin-image-search-mcp": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-Dspring.main.web-application-type=none",
        "-Dlogging.pattern.console=",
        "-jar",
        "varin-image-search-mcp/target/varin-image-search-mcp-0.0.1-SNAPSHOT.jar"
      ],
      "env": {}
    }
  }
}
```



10. 测试：

```java
@Test
void getMessagewithMCPClient() {
    String messagewithMCPClient = ialdaApp.getMessagewithMCPClient("我想找一些关于计算机类型的图片", UUID.randomUUID().toString());
    Assertions.assertNotNull(messagewithMCPClient);
}
```



11. 测试结果

>  在测试结果中我们可以看到，已经可以从[https://www.pexels.com/zh-cn](https://www.pexels.com/zh-cn)中查询到图片了，也可以看到toolCallbackProvider对象中也有2个mcp了。
>

```plain
以下是一些关于计算机类型的图片链接，您可以点击查看或下载：

- [https://images.pexels.com/photos/1416871/pexels-photo-1416871.jpeg](https://images.pexels.com/photos/1416871/pexels-photo-1416871.jpeg)
- [https://images.pexels.com/photos/33650825/pexels-photo-33650825.jpeg](https://images.pexels.com/photos/33650825/pexels-photo-33650825.jpeg)
- [https://images.pexels.com/photos/32664236/pexels-photo-32664236.jpeg](https://images.pexels.com/photos/32664236/pexels-photo-32664236.jpeg)
- [https://images.pexels.com/photos/32472475/pexels-photo-32472475.jpeg](https://images.pexels.com/photos/32472475/pexels-photo-32472475.jpeg)
- [https://images.pexels.com/photos/27153419/pexels-photo-27153419.jpeg](https://images.pexels.com/photos/27153419/pexels-photo-27153419.jpeg)

这些图片涵盖了不同类型的计算机设备，可用于学习、展示或其他用途。如果需要更多类型的图片，请告诉我！
```

![](https://developer.qcloudimg.com/http-save/yehe-5673264/545bd08c5375646838231eab4bf5a72e.png)



<h1 id="fb2l9">三、MCP服务端开发实战-图片搜索服务（SSE版本）</h1>

<h3 id="loMCR">服务端</h3>

> 步骤和stdio类似，需要修改的地方：
>

1. 添加新的sse配置文件，并将主配置文件的运行环境修改到sse

文件名称：application-sse.yml

```yaml
spring:
  ai:
    mcp:
      server:
        name: varin-image-search-mcp-server
        version: 0.0.1
        type: SYNC

        stdio: false

```

文件名称：application.yml

```plain
spring:
  application:
    name: varin-image-search-mcp
  profiles:
    active: sse
server:
  port: 9977
```

以上的修改就完成了sse版本的改造，可以启动程序

![](https://developer.qcloudimg.com/http-save/yehe-5673264/bd0278fe0bbad719e359995b49458898.png)

<h3 id="yL8Qq">客户端</h3>
1. 修改配置文件

```yaml
spring:
  ai:
    mcp:
      client:
#        stdio:
#         servers-configuration: classpath:mcp-servers.json
        sse:
          connections:
            server1:
              url: http://localhost:9977
```

测试效果：已经运行sse版本的mcp了

![](https://developer.qcloudimg.com/http-save/yehe-5673264/1b5ee76701ec4bd9c48065a3ba8d7ed7.png)



测试2：刚刚我们把本地的mcp配置注释了，要是我们恢复，测试的时候会不会出现三个mcp呢？

> 提示：多个同名的工具
>

![](https://developer.qcloudimg.com/http-save/yehe-5673264/3c7f4a5f092ccec61c00ecf5221d5645.png)

MCP 是一种开放协议，它标准化了应用程序如何向大模型提供上下文的方式。可以将 MCP 想象成 AI 应用的 USB 接口。就像 USB 为设备连接各种外设和配件提供了标准化方式一样，MCP 为 AI 模型连接不同的数据源和工具提供了标准化的方法。

AI 超级智能体全栈项目阶段六：自定义ToolCallding并实现集中注册

本文介绍了AI大模型工具调用（Tool Calling）的实现流程与Spring AI工具开发方法。使用@Tool注解标记方法。帮助开发者快速上手AI工具开发。

先锋会员

编程语言

MCP协议是AI应用的标准化接口，类似USB接口功能。文章详细介绍了MCP协议原理、SpringAI集成方法，以及实战开发图片搜索服务的过程，包含Stdio和SSE两种实现方式。通过MCP协议，开发者可以轻松扩展AI能力，实现工具与数据源的标准化连接。

服务器

Windows

JSON

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

AI 超级智能体全栈项目阶段六：自定义ToolCallding并实现集中注册-腾讯云开发者社区-腾讯云

AI 超级智能体全栈项目阶段六：自定义ToolCallding并实现集中注册

AI 超级智能体全栈项目阶段六：自定义ToolCallding并实现集中注册

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐