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 對象存儲服務的集成，可助力開發者高效操作對象存儲。

🚀 快速開始

克隆倉庫

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

設置環境變量

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

構建項目

mvn clean package

運行集成測試

# 運行 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}

📚 詳細文檔

項目結構

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 文件。

📞 聯繫方式

如果您有任何問題或建議，請隨時創建一個問題。