Spring AI MCP 服务器

这是一个利用 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": "AI 技术趋势 2025",
    "content": "这是一份介绍 2025 年当前 AI 技术趋势的演示文稿。涵盖生成式 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