spring ai 开发MCP服务器(stdio)

spring ai 开发MCP服务器(stdio)

一、什么是MCP（Model Context Protocol）

MCP（Model Context Protocol，模型上下文协议） ，2024年11月底，由 Anthropic 推出的一种开放标准，旨在统一大型语言模型（LLM）与外部数据源和工具之间的通信协议。MCP 的主要目的在于解决当前 AI 模型因数据孤岛限制而无法充分发挥潜力的难题，MCP 使得 AI 应用能够安全地访问和操作本地及远程数据，为 AI 应用提供了连接万物的接口。
spring ai 官网介绍 https://docs.spring.io/spring-ai/reference/1.0/api/mcp/mcp-overview.html
看到网上有很多node和python写的MCP服务器，我突发奇想，java是不是也可以写，就去研究了一下。

二、依赖及插件引入pom

<parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.4.4</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
<properties>
        <java.version>17</java.version>
        <spring-ai.version>1.0.0-M7</spring-ai.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-starter-mcp-server</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.ai</groupId>
                <artifactId>spring-ai-bom</artifactId>
                <version>${spring-ai.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

M7版本在我写博客的时候 webmvc和sse的功能似乎存在问题，并不能正常调用。JDK注意要使用17及以上的，官方的sdk就是需要17及以上的。

三、启动类编写注册工具

@SpringBootApplication
public class AiApplication {

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


//注册工具
    @Bean
    public ToolCallbackProvider CalculateTools (Calculate calculate) {
        return MethodToolCallbackProvider.builder().toolObjects(calculate).build();
    }



}

服务类

@Service
public class Calculate {
    //工具示例
    @Tool(description = "加法计算器")
    public String add(
            @ToolParam(description = "加数1", required = false) double a,
            @ToolParam(description = "加数2", required = false) double b
    ) {
        return String.valueOf(a + b);
    }


}

yaml文件

spring:
  ai:
    mcp:
      server:
        name: stdio-mcp-server
        version: 1.0.0
        type: SYNC

这样一个简单的MCP服务端就完成了
直接maven打包

接下去用cherrystudio进行测试
https://cherry-ai.com/
根据cherry的官网先配置好MCP的环境

MCP服务器配置如下图所示

cherry似乎不会去读系统环境变量直接绝对路径使用就行
C:\Users\49651.jdks\corretto-17.0.14\bin\java

-jar
-Dfile.encoding=UTF-8
E:\owind-git\ai_mcp_server\target\aicode-0.0.1-SNAPSHOT.jar
选择刚刚配置的MCP服务器

结果：

这个MCP实现的是一个简单的加法功能，可以看到大模型正确的去调用了这个MCP