MCP Server using Spring Boot Java

使用 Spring Boot Java 构建 MCP 服务

此 Model Context Protocol（MCP）服务使用 Spring Boot 和 Java 21 构建。本项目演示了如何创建一个为 AI 助手提供用户管理工具的 MCP 服务。

功能

• 使用 Spring AI 实现 MCP 服务功能
• 通过 MCP 提供用户管理工具
• 同步通信模式
• 支持标准输入/输出和服务器发送事件传输
• 集成 DummyJSON 外部 API 获取用户数据

技术

• Java 21
• Spring Boot 3.4.3
• Spring AI（Model Context Protocol）
• Project Lombok
• Maven

快速开始

前置条件

• Java 21 或更高版本
• Maven

安装

1. 克隆代码仓库

git clone https://github.com/yourusername/mcp-spring-java.git
cd mcp-spring-java

2. 构建项目

mvn clean package

3. 运行应用程序

java -jar target/mcp-spring-java-0.0.1-SNAPSHOT.jar

配置

MCP 服务在 application.yml 中配置：

• 服务运行在端口 8090
• 服务名称：my-dummy-users-server
• 同步通信模式
• 支持基于终端通信的 STDIO 传输
• 提供用于 SSE 通信的 /mcp/message 端点

可用工具

此服务提供以下用户管理工具：

• getAllUsers - 获取所有用户并支持分页
• getAllUsersDefault - 使用默认分页获取所有用户
• getUserById - 根据 ID 获取单个用户
• searchUsers - 根据查询内容搜索用户
• addUser - 添加新用户
• updateUser - 更新用户
• deleteUser - 删除用户

使用 Postman 测试

你可以使用 Postman 测试 MCP 服务端点：

1. 启动 MCP 服务

2. 打开 Postman 并创建新请求：

   • 方法：POST
   • URL：http://localhost:8090/mcp/message
   • 请求头：
     • Content-Type：application/json
     • Accept：application/json

3. 对于请求正文，使用以下 JSON 格式调用任意可用工具：

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "[TOOL_NAME]",
        "parameters": {
          "[PARAMETER_NAME]": "[PARAMETER_VALUE]"
        }
      }
    ]
  }
}

请求示例

获取所有用户（默认分页）

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "getAllUsersDefault",
        "parameters": {}
      }
    ]
  }
}

根据 ID 获取用户

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "getUserById",
        "parameters": {
          "id": 1
        }
      }
    ]
  }
}

搜索用户

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "searchUsers",
        "parameters": {
          "query": "John"
        }
      }
    ]
  }
}

响应将包含一个 JSON 对象，其中包含工具执行结果。

与 MCP 客户端搭配使用

你可以使用以下配置，在 MCP 客户端应用程序中配置此服务：

{
  "mcpServers": {
    "dummy-user-server": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-Dspring.main.web-application-type=none",
        "-Dlogging.pattern.console=",
        "-jar",
        "path/to/mcp-spring-java-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

许可证

本项目遵循 LICENSE 文件中规定的条款授权。