技术文档摘要

Spring AI MCP Server

这是一款利用Spring Boot和AI自动生成Excel和PPT文件的服务器。

主要功能

• 利用AI自动生成Excel文档
• 利用AI自动生成PPT演示文稿
• 通过RESTful API处理异步文档生成请求

技术栈

• Java 17
• Spring Boot 3.2.3
• Spring AI 0.8.0（使用OpenAI）
• Apache POI 5.2.5（用于生成Excel和PPT文件）

要求

• 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
   

API使用示例

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