Dan Vega Courses

🚀 Spring AI MCP 課程信息服務器

本項目是一個基於 Spring Boot 的應用程序，藉助 Spring AI MCP 框架實現了模型控制協議（MCP）服務器，用於提供課程信息。它創建了輕量級服務器，讓人工智能模型能與自定義數據服務交互，還可使用標準化工具。主要提供了檢索所有課程和按標題搜索特定課程兩個工具，是創建 MCP 服務器或集成外部數據源與 AI 模型的絕佳起點。

🚀 快速開始

1. 克隆倉庫

   git clone https://github.com/your-username/spring-ai-mcp.git
   cd spring-ai-mcp
   

2. 構建項目

   mvn clean install
   

3. 運行應用

   java -jar target/courses-0.0.1-SNAPSHOT.jar
   

✨ 主要特性

• 實現模型控制協議（MCP）服務器，提供課程信息。
• 提供檢索所有可用課程和按標題搜索特定課程兩個工具。
• 可作為創建自定義 MCP 服務器或集成外部數據源與 AI 模型的起點。

📦 安裝指南

項目要求

• Java 24
• Maven 3.8+
• Spring Boot 3.4.4
• Spring AI 1.0.0 - M6

依賴項

該項目依賴以下關鍵依賴項：

• Spring AI MCP 服務器：提供創建與 MCP 兼容服務器的基礎

  <dependency>
      <groupId>org.springframework.ai</groupId>
      <artifactId>spring-ai-mcp-server-spring-boot-starter</artifactId>
  </dependency>
  

• 用於演示的 Spring Boot Starter Web：提供 Web 組件以構建 MVC 應用程序

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
  

💻 使用示例

基礎用法

1. 獲取所有課程

curl http://localhost:8080/courses

2. 搜索課程

curl "http://localhost:8080/search?keyword=Java"

高級用法

在實際使用中，可根據業務需求對 CourseService 類中的搜索邏輯進行擴展，以實現更復雜的課程搜索功能。例如，可以根據課程的分類、講師等信息進行搜索。

📚 詳細文檔

項目結構

src/main/java/
├── CourseService.java       # 提供課程數據的業務邏輯
└── MCPServerApplication.java # 主應用程序類，啟動 Spring Boot 應用程序

功能實現

1. 創建服務類

import org.springframework.stereotype.Service;

@Service
public class CourseService {
    public List<Course> getAllCourses() {
        return List.of(
            new Course(1L, "Introduction to Java"),
            new Course(2L, "Advanced Python Programming")
        );
    }

    @Tool(name = "search_courses", description = "Search for courses containing a keyword")
    public List<Course> searchCourses(String keyword) {
        // 這裡添加搜索邏輯
        return this.getAllCourses().stream()
            .filter(course -> course.getTitle().toLowerCase().contains(keyword.toLowerCase()))
            .collect(Collectors.toList());
    }
}

2. 創建 Course 數據傳輸對象（DTO）

import java.util.Objects;

public record Course(
    Long id,
    String title
) {
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        Course course = (Course) o;
        return Objects.equals(id, course.id);
    }

    @Override
    public int hashCode() {
        return Objects.hash(id);
    }
}

配置 MCP 服務器

在 application.properties 文件中進行如下配置：

# 設置 MCP 服務器的端口
server.port = 8080

# 其他 Spring Boot 配置...

引言

MCP（模型控制協議）是一種用於在 AI 模型和外部數據源之間建立通信的協議。通過 Spring AI，您可以輕鬆地將這些服務公開為工具，供 AI 模型調用。

結論

通過此示例，您可以看到如何利用 Spring AI 的 MCP 服務器來公開自定義服務。這對於任何需要與 AI 模型交互的後端服務都非常有用。

更多詳細信息，請參考官方文檔。