Spring Ai MCP Server

🚀 Spring AI MCP Server

This is an Excel and PPT generation server based on Spring Boot and AI technology, which can efficiently handle document generation tasks.

🚀 Quick Start

To run the Spring AI MCP Server, follow these steps:

1. Set the environment variable: OPENAI_API_KEY=your_api_key
2. Build the application:

   ./gradlew clean build
   

3. Start the application:

   java -jar build/libs/spring-ai-mcp-server-0.0.1-SNAPSHOT.jar
   

✨ Features

• Automatically create Excel documents using AI.
• Automatically generate PPT presentations using AI.
• Handle asynchronous document generation requests through RESTful API.

🔧 Technical Details

Technology Stack

System Requirements

• Java 17 or higher is required.
• An OpenAI API key is needed.

💻 Usage Examples

Basic Usage

1. Create an Excel Document Request

curl -X POST http://localhost:8080/api/documents \
  -H "Content-Type: application/json" \
  -d '{
    "title": "2024 Quarterly Sales Report",
    "content": "Generate a report containing sales data for the first to third quarters of 2024. Show sales and totals by product category and display the growth rate for each quarter.",
    "documentType": "EXCEL",
    "sections": ["Sales Overview", "Product Category Performance", "Regional Performance"]
  }'

2. Create a PowerPoint Presentation Request

curl -X POST http://localhost:8080/api/documents \
  -H "Content-Type: application/json" \
  -d '{
    "title": "2025 Artificial Intelligence Technology Trends",
    "content": "A presentation introducing the current trends in artificial intelligence technology in 2025. Includes the development of generative AI, progress in large language models, AI ethics and regulation, and AI application cases in various industries.",
    "documentType": "POWERPOINT",
    "sections": ["Introduction", "Generative AI Development Trends", "Progress in Large Language Models", "AI Applications in Various Industries", "Ethics and Regulation", "Conclusion"]
  }'

3. Check Document Generation Status

curl -X GET http://localhost:8080/api/documents/{documentId}

4. Download the Generated Document

• Excel file:

  curl -X GET http://localhost:8080/api/documents/excel/download/{fileName}
  

• PowerPoint file:

  curl -X GET http://localhost:8080/api/documents/ppt/download/{fileName}
  

📚 Documentation

Configuration Options

You can adjust various settings in application.yml:

app:
  document:
    temp-dir: ${java.io.tmpdir}/spring-ai-mcp-server  # Temporary file storage path

Future Development Plans

• Add Markdown document generation functionality.
• Add automatic Confluence page generation functionality.
• Support more types of document templates.
• Implement automatic image and chart generation functionality.

📄 License

This project is licensed under the MIT License.