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 进行许可。