What is Mail Mcp Server

mail-mcp-server is an MCP Server built on Spring AI, designed to facilitate the sending of emails through an integrated email service.

Use cases

Use cases for mail-mcp-server include sending automated emails in response to user queries, integrating email notifications within chatbots, and facilitating email communication in enterprise applications.

How to use

To use mail-mcp-server, set up the environment with JDK 17 or higher and Spring Boot 3.4.5 or higher. Then, implement the server using the provided Spring AI SDK, which supports various communication methods such as STDIO, WebMVC, and WebFlux.

Key features

Key features of mail-mcp-server include seamless integration with email services, compliance with the Model Context Protocol (MCP) for standardized tool calls, and the ability to connect multiple large models and platforms with a single implementation.

Where to use

mail-mcp-server can be used in various fields such as customer support systems, automated notification services, and any application requiring email communication as part of its workflow.

通过Spring-AI快速构建MCP Server

• 科技部·研发中心·应用架构组
• 2025-05-21

1 MCP简介

MCP（Model Context Protocol，模型上下文协议）定义了应用程序和大模型之间交换上下文信息的方式。使开发者能够以一致的方式将各种数据源、工具和接口连接到大模型，就像USB让不同设备能够通过相同的标准连接一样。MCP的目标是创建一个通用标准，使AI应用程序的开发和集成变得更加简单和统一。

说人话：MCP就是一种大模型调用外部接口（function/tool call）的协议标准

引用一张网图，让大家更直观的感受MCP解构：

2 MCP的作用

2.1 提示词工程

我们来尝试一个简单的场景，如下图2，让大模型告诉我们今天是星期几？

大模型相当于一个脱机的、静态的智者，它并不知道当前时间，也不知道外面世界发生的变化。
在没有工具调用的情况下，大模型不能回答今天是星期几？这样的问题。

所以我们需要在提示词中提供我们的线索，比如这样问：2025年5月20日是星期几？，如下图3

如果我们让大模型在回答我问题的时候，能够知道今天是几月几日，问题不就解决了吗。于是，（function/tool call）出现了。
当我们给Agent添加了一个获取当前时间的工具后，再问今天是星期几？，大模型就能解答了，如下图4

这样我们就不用每次都把今天的日期输给大模型了，他自己去查，提升了自动化水平，显著提高用户体验。

MCP是将外部服务、数据与大模型结合的一种协议标准，有了MCP就能让大模型获取私域知识、完成特定指令的执行更加便捷。
我相信各大模型都会在后续的版本中强化MCP以提高调用的准确率

2.2 标准化

OpenAI、Google、Qwen、DeepSeek等各大模型都支持（function/tool call），但是在各LLM平台上，function call API
实现差异较大，开发者在切换LLM平台和大模型时需要重新对接，增加了适配成本，难以形成生态。
MCP的出现就是要解决这个痛点，充当大模型的"标准扩展坞"，让大模型能够轻松调用各种接口，并且MCP SERVER一次开发可以对接多个支持MCP的大模型和平台。

2.3 MCP的构成和调用过程

MCP由三个核心组件构成：Host、Client、Server。如下图5

• Host： 负责接收用户的提问并与大模型交互，比如：Dify、Cursor、Coze等；
• Client：当大模型决定需要调用外部工具时，Host中内置的Client会被激活，负责与恰当的Server建立连接并发送请求；
• Server：被Client调用的服务端。负责执行实际的指令，比如：查询数据库并返回对应的数据、调用邮箱的接口发送一份邮件、访问服务器文件系统并返回文件列表等。
  

MCP调用过程如下图6-1、图6-2

3 构建MCP Sever

实现MCP Server的技术框架已经出了很多，python、nodejs、java、golang等语言都有对应的SDK

3.1 Spring AI构建MCP Server

3.1.1 环境要求

• jdk >= 17
• spring-boot >= 3.4.5
• spring-ai >=1.0.0

3.1.2 构建项目

Spring AI支持STDIO、WebMVC和WebFlux三种通讯方式构建MCP Server：

• spring-ai-starter-mcp-server：支持标准输入输出的基本服务，适合本机嵌入
• spring-ai-starter-mcp-server-webmvc：基于Spring MVC的SSE通讯实现的服务
• spring-ai-starter-mcp-server-webflux：基于Spring WebFlux的SSE通讯实现的服务

我这里使用WebFlux（推荐）构建一个通过行内邮箱发送邮件的MCP Server，步骤如下：

• 1、pom.xml中添加依赖

<!-- lookup parent from repository -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.4.5</version>
    <relativePath />
</parent>

<groupId>com.zhangsd</groupId>
<artifactId>mail-mcp-server</artifactId>
<version>1.0-SNAPSHOT</version>

<properties>
    <maven.compiler.source>21</maven.compiler.source>
    <maven.compiler.target>21</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-bom</artifactId>
            <version>1.0.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <!-- spring ai mcp server依赖 -->
    <dependency>
        <groupId>org.springframework.ai</groupId>
        <artifactId>spring-ai-starter-mcp-server-webflux</artifactId>
        <exclusions>
            <exclusion>
                <artifactId>spring-boot-starter-logging</artifactId>
                <groupId>org.springframework.boot</groupId>
            </exclusion>
        </exclusions>
    </dependency>
    <!-- 邮件 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-mail</artifactId>
    </dependency>
    <!-- 日志 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-log4j2</artifactId>
    </dependency>
</dependencies>

• 2、创建启动入口类

/**
 * @author zhangshdiong
 * @date 2025/5/8 11:11
 * @description 启动入口
 **/
@SpringBootApplication
public class McpServerApplication {

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

• 3、在application.yml中添加必要的配置

spring:
  application:
    name: mail-mcp-server
  jackson:
    default-property-inclusion: non_null
  ai:
    mcp:
      server:
        # mcp server的名称，在查询tools的接口中会返回给client
        # 在多个server的情况下，准确的名称有利于大模型选中恰当的server
        name: ${spring.application.name}
        version: 1.0.0
        # 支持SYNC/ASYNC
        # SYNC：同步服务模式，默认值。专为简单`请求-响应`模式而设计
        # ASYNC：异步服务模式。针对非阻塞作进行了优化。适合耗时长的复杂任务
        type: SYNC
        # Enable/disable stdio transport
        # 开启后，将通过标准输入/输出进行通讯，通过进程间通信（IPC）实现，适合本地部署场景
        stdio: false
        # 调用initialize、notifications/initialized、tools/list、tools/call等接口的content-path
        # 默认：/sse/message
        sse-message-endpoint: /mcp/message
        # `Created new SSE connection for sessions`接口的content-path
        # 默认：/sse
        sse-endpoint: /sse
        # 资源更改通知
        resource-change-notification: true
        # 工具更改通知
        tool-change-notification: true
        # 提示词更改通知
        prompt-change-notification: true
  # 邮箱服务配置
  mail:
    default-encoding: UTF-8
    host: @dyn.mail.host@
    port: @dyn.mail.port@
    username: @dyn.mail.username@
    password: @dyn.mail.password@
    protocol: smtp
    properties:
      mail:
        smtp:
          auth: true
          ssl:
            enable: true
          starttls:
            enable: true
            required: true

• 4、创建并编写MCP Server的业务逻辑（通过姓名查找收件地址、发送邮件）

@Tool注解是Spring AI MCP框架中用于快速暴露业务能力为MCP协议工具的核心注解，该注解将Service方法自动映射成MCP协议工具，并且通过注解的属性description对工具进行描述。

🚩使用@Tool注解标注要提供为MCP协议工具的方法，并使用description属性为工具添加合适的说明

🚩使用@ToolParam注解标注工具方法的参数，使用description属性为参数添加合适的说明，使用required属性标注参数是否必传，默认为true

package com.zsd.mcp.mail.impl;

import com.zsd.mcp.mail.MailService;
import com.zsd.mcp.mail.api.FindContactInput;
import com.zsd.mcp.mail.api.FindContactOutput;
import com.zsd.mcp.mail.api.SendMailInput;
import com.zsd.mcp.mail.api.SendMailOutput;
import lombok.extern.slf4j.Slf4j;
import org.springframework.ai.tool.annotation.Tool;
import org.springframework.ai.tool.annotation.ToolParam;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.stereotype.Service;

import java.util.HashMap;
import java.util.Map;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

/**
 * @author zhangshdiong
 * @date 2025/5/9 10:46
 * @description 邮件发送服务
 **/
@Slf4j
@Service
public class MailServiceImpl implements MailService {

  /**模拟数据*/
  private static final Map<String, String> contacts = new HashMap<>();

  static {
    contacts.put("何龙", "[email protected]");
    contacts.put("刘显波", "[email protected]");
    contacts.put("张仕东", "[email protected]");
    contacts.put("杨帆", "[email protected]");
    contacts.put("涂太松", "[email protected]");
    contacts.put("谭伟", "[email protected]");
    contacts.put("张沛", "[email protected]");
    contacts.put("段龙", "[email protected]");
    contacts.put("赖健", "[email protected]");
    contacts.put("邱季", "[email protected]");
    contacts.put("蔡玉成", "[email protected]");
  }

  @Value("${spring.mail.username}")
  private String from;

  @Autowired
  private JavaMailSender mailSender;

  @Tool(description = "Create and send a new email message.")
  @Override
  public SendMailOutput sendMail(@ToolParam(description = "发送邮件的请求参数") SendMailInput input) {
    log.info("====收到 MCP.sendMail 调用请求：{}", input);
    SimpleMailMessage simpleMailMessage = new SimpleMailMessage();
    simpleMailMessage.setFrom(from);
    simpleMailMessage.setTo(input.getTo());
    simpleMailMessage.setCc();
    simpleMailMessage.setSubject(input.getSubject());
    simpleMailMessage.setText(input.getBody());
    try{
      mailSender.send(simpleMailMessage);
    }catch (Exception e){
      log.error("send mail failed:", e);
      throw e;
    }
    return SendMailOutput.builder()
            .resultCode("00")
            .resultMsg("发送成功")
            .build();
  }

  @Tool(description = "根据联系人姓名查找对应的邮件地址")
  @Override
  public FindContactOutput findContact(@ToolParam(description = "查找联系人请求参数") FindContactInput input){
    log.info("===收到 MCP.findContact 调用请求:{}", input);
    for (Map.Entry<String, String> contact : contacts.entrySet()){
      //模糊匹配
      Pattern contactPattern = Pattern.compile(".*" + input.getName() + ".*");
      Matcher matcher = contactPattern.matcher(contact.getKey());
      if(matcher.matches()){
        return FindContactOutput.builder()
                .name(contact.getKey())
                .email(contact.getValue())
                .resultCode("00")
                .resultMsg("查找成功")
                .build();
      }
    }
    return FindContactOutput.builder()
            .resultCode("01")
            .resultMsg("未找到该联系人")
            .build();
  }
}

package com.zsd.mcp.mail;

import com.zsd.mcp.mail.api.FindContactInput;
import com.zsd.mcp.mail.api.FindContactOutput;
import com.zsd.mcp.mail.api.SendMailInput;
import com.zsd.mcp.mail.api.SendMailOutput;

/**
 * @author zhangshdiong
 * @date 2025/5/9 10:46
 * @description 电子邮件服务接口定义
 **/
public interface MailService {

  /**
   * 发送电子邮件
   * @param input 请求
   * @return 响应
   */
  SendMailOutput sendMail(SendMailInput input);

  /**
   * 通过姓名查找收邮件地址
   * @param input 请求
   * @return 响应
   */
  FindContactOutput findContact(FindContactInput input);

}

package com.zsd.mcp.mail.api;

import com.fasterxml.jackson.annotation.JsonProperty;
import jdk.jfr.Description;
import lombok.Builder;
import lombok.Data;
import org.springframework.ai.tool.annotation.ToolParam;

/**
 * @author zhangshdiong
 * @date 2025/5/9 10:48
 * @description 发送邮件请求实体
 **/
@Data
@Builder
@Description("发送邮件请求参数")
public class SendMailInput {

    @JsonProperty(required = true)
    @Description("接收邮件的地址")
    @ToolParam(description = "接收邮件的地址")
    String to;

    @Description("抄送邮件地址")
    @ToolParam(description = "抄送邮件地址", required = false)
    String cc;

    @JsonProperty(required = true)
    @Description("邮件主题")
    @ToolParam(description = "邮件主题")
    String subject;

    @JsonProperty(required = true)
    @Description("邮件内容")
    @ToolParam(description = "邮件内容")
    String body;
}

• 5、注册工具到MCP Server

    @Bean
    public ToolCallbackProvider mailTools(MailService mailService) {
        return MethodToolCallbackProvider.builder().toolObjects(mailService).build();
    }

3.1.3 Client调用

3.1.3.1 Spring AI构建MCP Client

Spring AI构建MCP Client官方示例

• 1、pom.xml中添加依赖

<parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-parent</artifactId>
  <version>3.4.5</version>
  <relativePath /> <!-- lookup parent from repository -->
</parent>

<groupId>com.zhangsd</groupId>
<artifactId>mail-mcp-client</artifactId>
<version>1.0-SNAPSHOT</version>

<properties>
  <maven.compiler.source>21</maven.compiler.source>
  <maven.compiler.target>21</maven.compiler.target>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework.ai</groupId>
      <artifactId>spring-ai-bom</artifactId>
      <version>1.0.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-mcp-client</artifactId>
    <exclusions>
      <exclusion>
        <artifactId>spring-boot-starter-logging</artifactId>
        <groupId>org.springframework.boot</groupId>
      </exclusion>
    </exclusions>
  </dependency>
  <dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-model-openai</artifactId>
  </dependency>
  <!-- 日志依赖 -->
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-log4j2</artifactId>
  </dependency>
</dependencies>

• 2、创建启动入口

package com.zhangsd;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

import java.util.Scanner;

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

• 3、在application.yml中添加配置

spring:
  main:
    web-application-type: none
  application:
    name: mail-mcp-client
  jackson:
    default-property-inclusion: non_null
  ai:
    model:
      chat: openai
    openai:
      base-url: @dyn.openai.base-url@
      api-key: @dyn.openai.api-key@
      chat:
        completions-path: /chat/completions
        options:
          # chat默认使用的模型名
          # Qwen/Qwen3-235B-A22B, deepseek-ai/DeepSeek-R1, deepseek-ai/DeepSeek-V3
          model: 'deepseek-ai/DeepSeek-V3'
    mcp:
      client:
        # 是否开启MCP Client，默认 true
        enabled: true
        # MCP客户端实例名
        name: mail-assistant
        # 版本号
        version: 1.0.0
        # 是否在创建时初始化客户端，默认 true
        initialized: true
        # 请求的超时时间，默认20s
        request-timeout: 20s
        # 客户端类型（SYNC/ASYNC）
        type: SYNC
        sse:
          connections:
            mail-mcp-server:
              url: http://127.0.0.1:9088

• 4、创建ChatClient并添加可用工具

 package com.zhangsd.mcp.client;

import org.springframework.ai.chat.client.ChatClient;
import org.springframework.ai.chat.client.advisor.MessageChatMemoryAdvisor;
import org.springframework.ai.chat.memory.ChatMemory;
import org.springframework.ai.chat.memory.MessageWindowChatMemory;
import org.springframework.ai.tool.ToolCallbackProvider;
import org.springframework.stereotype.Component;
import reactor.core.publisher.Flux;

/**
 * @author zhangshdiong
 * @date 2025/5/28 17:28
 * @description 邮件MCP客户端
 **/
@Component
public class MailClient {

  private final ChatClient chatClient;

  /**
   * 构造方法
   * @param chatClientBuilder spring ai根据yml中的spring.ai.model配置自动装配的对话客户端builder
   * @param toolCallbackProvider spring ai根据yml中的spring.ai.mcp.client.sse.connections配置自动装配的mcp工具provider
   */
  public MailClient(ChatClient.Builder chatClientBuilder, ToolCallbackProvider toolCallbackProvider){
    //创建会话记忆窗口，最大10轮
    ChatMemory chatMemory = MessageWindowChatMemory.builder().maxMessages(10).build();
    //创建与大模型的交互客户端
    this.chatClient = chatClientBuilder.defaultSystem("""
                    你是一个聪明的邮件助手，根据用户指令发送电子邮件，步骤如下：
                    1、先获取工具列表，找到需要的工具和对应的参数，所有的工具调用都要基于事实，不要猜测，不要假设；
                    2、根据用户的要求生成合理的邮件内容，根据邮件内容生成合适的邮件主题；邮件内容需要包含称呼、问候语、正文、祝福语；发件人是四川天府银行科技部的张仕东；
                    3、如果用户没有明确给出收件地址，而是姓名，请调用工具查找联系人的邮件地址；如果未查找到联系人，请提示用户提供准确的姓名或直接给出邮件地址；
                    4、在发送前请向用户确认即将发送的邮件标题、内容、收件地址等信息，得到用户肯定确认后调用对应的工具发送邮件；
                    5、在调用工具时，如果缺失参数请向用户询问，直到收集完全部的调用参数后调用工具完成发送，并将发送结果反馈给用户。""")
            .defaultAdvisors(MessageChatMemoryAdvisor.builder(chatMemory).build()) //添加会话记忆
            .defaultToolCallbacks(toolCallbackProvider) //添加工具列表
            .build();
  }

  /**
   * 发送邮件
   * @param command 用户指令
   * @return 运行结果
   */
  public Flux<String> sendMail(String command){
    return chatClient.prompt(command)
            .stream()
            .content();
  }
}

• 5、创建一个用户的交互接口，这里使用命令行交互

    /**
     * 创建一个命令行用户交互
     * @param mailClient 邮件智能体
     * @return 命令行输出
     */
    @Bean
    CommandLineRunner cli(MailClient mailClient){
        return args -> {
            var scanner = new Scanner(System.in);
            System.out.println("Agent: 我是一个非常聪明的邮件助手，能够帮您编辑并发送邮件。");
            while (true){
                System.out.print("User: ");
                //采集用户输入
                String userCommand = scanner.nextLine();
                if(StringUtils.isBlank(userCommand)){
                    System.out.println("System: 请输入您的指令");
                    continue;
                }
                if(StringUtils.containsAny(userCommand, "exit", "退出")){
                    break;
                }
                //向智能体发送用户指令
                Flux<String> sendResponse = mailClient.sendMail(userCommand);
                System.out.print("Agent: ");
                //大模型返回的流式输出
                sendResponse
                        .doOnNext(System.out::print)
                        .blockLast();
                System.out.println();
            }
        };
    }

• 6、运行效果

PS：
目前，原生的Spring AI暂不支持将非DeepSeek模型的推理过程流式输出，issue上已经有人提了适配Qwen3，个人推测在后续版本中应该会支持推理类模型而不止特定的推理模型。
同时也不支持将工具调用过程在返回中输出，官网上说将在后续版本中增加这个支持。

3.1.3.2 Dify MCP SSE 插件

除了使用Spring AI构建一个MCP Client外，现在很多智能应用平台都支持MCP调用，如：Dify、Cursor、COZE等，我这里使用Dify

• 1、下载MCP SSE插件

在Dify的插件市场搜索MCP SSE关键字，选中对应的插件并点击安装，如下图7

• 2、配置MCP Server地址

MCP SSE插件安装好后，在插件列表中将其选中，点击授权，填写MCP服务配置，如下图8

{
  "server_name": {
    "url": "http://${server_ip}:${server_port}/mcp",
    "headers": {},
    "timeout": 60,
    "sse_read_timeout": 300
  }
}

• 3、创建一个Agent，配置一个大模型，填写合适的提示词，并添加MCP SSE工具，如下图9

提示词示例：

你是一个聪明能干的邮件助手，根据用户指令发送电子邮件，步骤如下：
1、先获取工具列表，找到需要的工具和对应的参数；
2、根据用户的要求生成合理的邮件内容，根据邮件内容生成合适的邮件主题；邮件内容需要包含称呼、问候语、正文、祝福语；
3、如果用户没有明确给出收件地址，而是姓名，请使用姓名拼音的小写加上@xxx.com后缀作为收件地址；如：张三的收件地址为[email protected]；
4、在发送前请向用户确认即将发送的邮件标题、内容、收件地址等信息，得到用户肯定确认后调用对应的工具发送邮件；
5、在调用工具时，如果缺失参数请向用户询问，直到收集完全部的调用参数后调用工具完成发送，并将发送结果反馈给用户。

• 4、使用效果
  输入给张**发送一封邮件，告诉他5月31日至6月2日端午节放假，放假期间注意出行安全，按时返岗，
  Agent会根据提示词组装邮件参数，并调用对应的MCP工具完成邮件发送，如下图10-1和图10-2，收到的邮件如图11
  
  
  

4 快速启动

完整项目源码

• mail-mcp-server

• mail-mcp-client

• 快速启动包

将压缩包下载到本地后执行以下命令可快速启动

unzip mail-mcp.zip
cd mail-mcp

# =====启动 mcp server=====
# 将配置文件中的邮箱服务配置修改为自己的邮件配置
vi start_mail-mcp-server.sh

sh start_mail-mcp-server.sh
# =========================

# =====启动 mcp client=====
# 将配置文件中的大模型配置修改为自己的
vi start_mail-mcp-client.sh

sh start_mail-mcp-client.sh
# =========================

5 常见问题

• 1、本机容器启动的Dify连不上本机启动的MCP Server

  配置MCP Server时，一定要使用本机的IP地址，在Dify中localhost、127.0.0.1指向的是容器。

• 2、MCP Client从tool/list查询回的接口参数缺少描述，导致大模型不能正确组装调用参数

  使用@ToolParam注解标注工具方法的每一个参数，并使用description属性为参数添加合适的说明，使用required属性标注参数是否必传，默认为true。
  如果参数是一个VO，请使用为VO的每一个成员变量添加@ToolParam注解。

  下面是mail-mcp-server的tool/list返回的服务端全部工具列表示例。
  准确的工具name和description有利于提高大模型选对工具的准确率，准确的参数名和描述则有利于提高大模型组装工具参数的准确率。

{
  "mcp_sse_list_tools": "MCP Server tools list: \n[{'name': 'sendMail', 'description': 'Create and send a new email message.', 'parameters': {'type': 'object', 'properties': {'input': {'type': 'object', 'properties': {'body': {'type': 'string', 'description': '邮件内容'}, 'subject': {'type': 'string', 'description': '邮件主题'}, 'to': {'type': 'string', 'description': '接收邮件的地址'}}, 'required': ['body', 'subject', 'to'], 'description': '发送邮件的请求参数'}}, 'required': ['input'], 'additionalProperties': False}}]"
}

[
  {
    "name": "sendMail",
    "description": "Create and send a new email message.",
    "parameters": {
      "type": "object",
      "properties": {
        "input": {
          "type": "object",
          "properties": {
            "body": {
              "type": "string",
              "description": "邮件内容"
            },
            "subject": {
              "type": "string",
              "description": "邮件主题"
            },
            "to": {
              "type": "string",
              "description": "接收邮件的地址"
            }
          },
          "required": [
            "body",
            "subject",
            "to"
          ],
          "description": "发送邮件的请求参数"
        }
      },
      "required": [
        "input"
      ],
      "additionalProperties": false
    }
  }
]

• 3、tool/list接口返回的工具参数多了一层para0

  其实也不影响使用，大模型会按照格式自行组装参数。

  请将spring-boot版本升级到3.4.5，spring-ai版本使用最新的正式版1.0.0。
  或者，通过快速组织依赖的网站重新创建一个干净的工程

• 4、调用MCP工具时，总是不能一次就调用成功，需要ReAct几次才能成功

  工具调用准确率，大参数模型优于小参数模型，思考模型优于不思考模型。在工具数量达到一定数量时，调用成功率也会下降。
  恰当的提示词能够提高调用成功率。

6 推荐网站

• 1、快速组织依赖的网站
• 2、各种编程语言的MCP SDK （spring-ai-mcp依赖了该项目的java sdk）
• 3、Spring AI官方文档
• 4、Spring AI MCP示例项目源码
• 5、MCP工具集合
• 6、Dify平台MCP SSE插件配置介绍