Spring Boot AI MCP Server

Spring Boot AI MCP 服务

概览

此项目是一个 Spring Boot 应用，用于为 AI 驱动的应用实现模型-控制器-展示器（MCP）架构模式。它为使用 Spring AI 和 OpenAI 集成构建 AI 增强型应用提供了基础。

功能

• Spring Boot 3.2.3 和 Java 17
• 集成 Spring AI 与 OpenAI
• MCP 架构模式
• RESTful API 端点
• 异常处理
• 验证
• 单元测试

架构

项目遵循 MCP（模型-控制器-展示器）架构模式：

• 模型：表示数据和业务逻辑
• 控制器：处理 HTTP 请求和响应
• 展示器：格式化用于展示的数据

项目结构

src/
├── main/
│   ├── java/
│   │   └── com/
│   │       └── junie/
│   │           └── mcp/
│   │               ├── ai/
│   │               │   ├── config/
│   │               │   ├── controller/
│   │               │   ├── dto/
│   │               │   └── service/
│   │               └── common/
│   │                   ├── dto/
│   │                   ├── entity/
│   │                   └── exception/
│   └── resources/
│       └── application.properties
└── test/
    └── java/
        └── com/
            └── junie/
                └── mcp/
                    └── ai/
                        └── service/

开始使用

先决条件

• Java 17 或更高版本
• Gradle 8 或更高版本
• OpenAI API 密钥

配置

在 application.properties 文件中设置 OpenAI API 密钥，或将其设置为环境变量：

spring.ai.openai.api-key=${OPENAI_API_KEY}

构建项目

./gradlew build

运行项目

./gradlew bootRun

API 端点

生成 AI 响应

POST /api/v1/ai/generate

请求正文：

{
  "prompt": "Your prompt here"
}

响应：

{
  "success": true,
  "message": "Success",
  "data": {
    "content": "AI-generated response"
  },
  "timestamp": "2023-06-01T12:00:00"
}

许可证

此项目采用 MIT 许可证，详情请参阅 LICENSE 文件。