🚀 使用 Spring Boot Java 实现的 MCP 服务器

本项目是一个基于 Spring Boot 和 Java 21 实现的 Model Context Protocol (MCP) 服务器，它展示了如何创建一个能够提供 AI 助手用户管理工具的 MCP 服务器，为相关开发提供了实用的范例。

✨ 主要特性

• 功能实现：借助 Spring AI 实现 MCP 服务器的核心功能。
• 用户管理：通过 MCP 接口提供丰富的用户管理工具。
• 通信模式：支持同步通信模式，保障数据交互的稳定性。
• 传输方式：支持标准 I/O 和 Server-Sent Events (SSE) 两种传输方式，满足不同场景需求。
• 数据交互：集成 DummyJSON 外部 API 进行用户数据的交互。

📦 安装指南

先决条件

• 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
• 通信模式：同步通信模式
• 支持终端基于标准 I/O 的通信
• 提供 /mcp/message 端点用于 SSE 通信

可用工具

服务器公开了以下用户管理工具：

• 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": "example"
        }
      }
    ]
  }
}

📄 许可证

本项目使用 Apache License 2.0 许可证。