Spring Ai MCP Server

🚀 Spring AI MCP 服務器

Spring AI MCP 服務器是一個基於 Spring Boot 和 AI 技術構建的強大工具，它能夠自動生成 Excel 和 PPT 文檔，為用戶提供高效便捷的文檔生成服務。

🚀 快速開始

Spring AI MCP 服務器的部署過程簡單明瞭。按照以下步驟操作，即可快速啟動服務：

1. 設置環境變量：OPENAI_API_KEY=your_api_key
2. 構建應用程序：

   ./gradlew clean build
   

3. 啟動應用程序：

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

✨ 主要特性

• 智能文檔生成：利用 AI 技術自動創建 Excel 文檔和 PPT 演示文稿，節省大量時間和精力。
• 異步處理：通過 RESTful API 處理異步文檔生成請求，提高系統的響應速度和處理效率。

📦 安裝指南

系統要求

• 需要 Java 17 或更高版本
• OpenAI API 密鑰

安裝步驟

1. 設置環境變量：OPENAI_API_KEY=your_api_key
2. 構建應用程序：

   ./gradlew clean build
   

3. 啟動應用程序：

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

💻 使用示例

基礎用法

1. 創建 Excel 文檔請求

curl -X POST http://localhost:8080/api/documents \
  -H "Content-Type: application/json" \
  -d '{
    "title": "2024年季度銷售報告",
    "content": "生成包含2024年第一季度至第三季度銷售額數據的報告。請按產品類別顯示銷售額和總計，並顯示各季度的增長率。",
    "documentType": "EXCEL",
    "sections": ["銷售概述", "產品類別業績", "地區業績"]
  }'

2. 創建 PowerPoint 演示文稿請求

curl -X POST http://localhost:8080/api/documents \
  -H "Content-Type: application/json" \
  -d '{
    "title": "2025年人工智能技術趨勢",
    "content": "介紹2025年當前人工智能技術趨勢的演示文稿。包括生成式AI發展、大型語言模型進展、AI倫理和監管、各行業AI應用案例等。",
    "documentType": "POWERPOINT",
    "sections": ["引言", "生成式AI發展趨勢", "大型語言模型進展", "各行業AI應用", "倫理與監管", "結論"]
  }'

高級用法

3. 文檔生成狀態檢查

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

4. 下載生成的文檔

• Excel 文件：

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

• PowerPoint 文件：

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

📚 詳細文檔

配置選項

在application.yml中可以調整多種設置：

app:
  document:
    temp-dir: ${java.io.tmpdir}/spring-ai-mcp-server  # 臨時文件存儲路徑

未來開發計劃

• 添加 Markdown 文檔生成功能
• 添加 Confluence 頁面自動生成功能
• 支持更多類型的文檔模板
• 實現圖像和圖表的自動生成功能

🔧 技術細節

技術棧

📄 許可證

本項目採用 MIT License 進行許可。