Spring Boot AI Cloudflare R2 MCP Server

Spring Boot AI Cloudflare R2 MCP 服务

English | 简体中文

简介

Spring Boot AI Cloudflare R2 MCP 服务是一个基于 Spring Boot 和 Spring AI 实现的 Model Context Protocol（MCP）服务，可集成 Cloudflare R2 对象存储服务。

项目结构

src/main/java/com/lskun/mcp/
├── SpringBootAiCloudflareR2McpServerApplication.java (Application entry)
├── config/
│   └── McpConfiguration.java (MCP configuration class)
└── service/
    └── R2ServiceClient.java (R2 service client)

功能特性

• 全面支持 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}

快速开始

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. 运行集成测试：

# Run all tests in R2ServiceClientTest
mvn test -Dtest=R2ServiceClientTest

# Or run a specific test method
mvn test -Dtest=R2ServiceClientTest#testListBuckets

测试套件涵盖所有 R2 操作：

• 存储桶操作（列出、创建、删除）
• 对象操作（上传、下载、列出、删除）
• 内容格式处理（文本、base64、文件路径）
• 对象元数据管理

API 参考

该服务提供以下主要功能：

• 列出存储桶
• 创建/删除存储桶
• 上传/下载对象
• 列出存储桶中的对象
• 获取对象元数据
• 删除对象

开发

项目使用 Spring Boot 3.4.4 和 Spring AI 1.0.0-M6。主要组件包括：

• R2ServiceClient：R2 操作的核心服务类
• McpConfiguration：MCP 工具配置
• 涵盖所有操作的集成测试

贡献

1. Fork 仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建新的 Pull Request

许可证

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

联系方式

如有任何问题或建议，请随时创建 issue。