Spring Boot Ai Cloudflare R2 MCP Server

🚀 Spring Boot AI 云flare R2 MCP サーバー

Spring Boot AI 云flare R2 MCP サーバーは、Spring Boot と Spring AI をベースにした Model Context Protocol (MCP) サーバーの実装です。Cloudflare R2 オブジェクトストレージサービスとの統合を提供します。

🚀 クイックスタート

1. リポジトリをクローンします：

git clone https://github.com/lskun/spring-boot-ai-cloudflare-r2-mcp-server.git

2. 環境変数を設定します：

export R2_ACCESS_KEY_ID=your_access_key_id
export R2_SECRET_ACCESS_KEY=your_secret_access_key
export R2_ENDPOINT=your_r2_endpoint

3. プロジェクトをビルドします：

mvn clean package

4. 統合テストを実行します：

# R2ServiceClientTest 内のすべてのテストを実行
mvn test -Dtest=R2ServiceClientTest

# または特定のテストメソッドを実行
mvn test -Dtest=R2ServiceClientTest#testListBuckets

テストスイートには、すべての R2 操作の包括的なテストが含まれています：

• バケット操作（一覧表示、作成、削除）
• オブジェクト操作（アップロード、ダウンロード、一覧表示、削除）
• コンテンツ形式の処理（テキスト、Base64、ファイルパス）
• オブジェクトメタデータ管理

✨ 主な機能

• Cloudflare R2 オブジェクトストレージ操作を完全にサポート
• Spring AI の MCP サーバーを統合
• 複数のファイルタイプ（テキスト、バイナリなど）をサポート
• 包括的なテストカバレッジを備える
• 設定とデプロイが容易

📦 インストール

前提条件

• JDK 17 以上
• Maven 3.6 以上
• Cloudflare R2 アカウントと認証情報

設定

application.properties ファイルに以下の内容を追加または変更して、R2 認証情報を設定します：

r2.access-key-id=${R2_ACCESS_KEY_ID}
r2.secret-access-key=${R2_SECRET_ACCESS_KEY}
r2.endpoint=${R2_ENDPOINT}

💻 使用例

基本的な使用法

このサーバーを使用することで、Cloudflare R2 オブジェクトストレージの操作を簡単に行うことができます。以下の手順で、サーバーを起動して操作を行うことができます。

📚 ドキュメント

プロジェクト構造

src/main/java/com/lskun/mcp/
├── SpringBootAiCloudflareR2McpServerApplication.java（アプリケーションエントリーポイント）
├── config/
│   └── McpConfiguration.java（MCP 設定クラス）
└── service/
    └── R2ServiceClient.java（R2 サービスクライアント）

API リファレンス

このサービスは以下の主要機能を提供します：

• バケットの一覧表示
• バケットの作成/削除
• オブジェクトのアップロード/ダウンロード
• バケット内のオブジェクトの一覧表示
• オブジェクトメタデータの取得
• オブジェクトの削除

開発情報

このプロジェクトは Spring Boot 3.4.4 と Spring AI 1.0.0 - M6 を使用しています。主なコンポーネントは以下の通りです：

• R2ServiceClient：R2 操作を実行する核心サービスクラス
• McpConfiguration：MCP ツールの設定
• すべての操作の統合テスト

🤝 貢献ガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. 新しい Pull Request を作成します。

📄 ライセンス

このプロジェクトは MIT License の下で公開されています。詳細は LICENSE ファイルを参照してください。

📞 連絡先

何か質問や提案がある場合は、いつでも Issue を作成してください。