Spring Boot Ai Cloudflare R2 MCP Server

🚀 Spring Boot AI Cloudflare R2 MCP Server

The Spring Boot AI Cloudflare R2 MCP Server is an implementation of the Model Context Protocol (MCP) server based on Spring Boot and Spring AI, offering integration with the Cloudflare R2 object storage service.

🚀 Quick Start

1. Clone the repository:

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

2. Set up environment variables:

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. Build the project:

mvn clean package

4. Run integration tests:

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

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

The test suite comprehensively tests all R2 operations:

• Bucket operations (list, create, delete)
• Object operations (upload, download, list, delete)
• Content format handling (text, Base64, file path)
• Object metadata management

✨ Features

• Fully support Cloudflare R2 object storage operations.
• Integrate Spring AI's MCP server.
• Support multiple file types (text, binary, etc.).
• Have comprehensive test coverage.
• Be easy to configure and deploy.

📦 Installation

Prerequisites

• JDK 17 or higher.
• Maven 3.6 or higher.
• A Cloudflare R2 account and credentials.

Configuration

Add or modify the following content in the application.properties file to set your R2 credentials:

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

📚 Documentation

Project Structure

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

API Reference

The service provides the following main functions:

• List buckets.
• Create/delete buckets.
• Upload/download objects.
• List objects in a bucket.
• Get object metadata.
• Delete objects.

Development Information

The project uses Spring Boot 3.4.4 and Spring AI 1.0.0 - M6. The main components include:

• R2ServiceClient: The core service class for performing R2 operations.
• McpConfiguration: MCP tool configuration.
• Integration tests for all operations.

🤝 Contribution Guidelines

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Create a new Pull Request.

📄 License

This project is released under the MIT License. Please refer to the LICENSE file for details.

📞 Contact

If you have any questions or suggestions, please feel free to create an issue.