Spring Boot AI MCP Server

Spring Boot AI MCP Server

概要

このプロジェクトは、AI を活用したアプリケーション向けに Model-Controller-Presenter（MCP）アーキテクチャパターンを実装する Spring Boot アプリケーションです。Spring AI と OpenAI の統合を使用して、AI 機能を強化したアプリケーションを構築するための基盤を提供します。

機能

• Java 17 対応の Spring Boot 3.2.3
• OpenAI との Spring AI 統合
• MCP アーキテクチャパターン
• RESTful API エンドポイント
• 例外処理
• バリデーション
• 単体テスト

アーキテクチャ

このプロジェクトでは、MCP（Model-Controller-Presenter）アーキテクチャパターンを採用しています。

• Model：データとビジネスロジックを表します
• Controller：HTTP リクエストとレスポンスを処理します
• Presenter：表示用にデータをフォーマットします

プロジェクト構成

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 ファイルを参照してください。