MCP 服务器（符合 MCP 协议）

概述

此服务器现在是一个符合 Model Context Protocol (MCP) 标准的 MCP 服务器。它通过 MCP 协议公开了文档生成功能，允许与 AI 主机（例如 Copilot、Cursor、Claude Desktop）集成。

MCP 功能

• MCP 工具： generateDocument — 从提示生成 PDF、DOCX、PPTX 或 XLSX 文件。
• 传输层： 标准输入输出（本地，默认）。如果需要，可以添加服务器发送事件（SSE）以支持网络通信。
• 模式验证： 使用 zod 进行输入验证。
• 可扩展性： 可以轻松添加更多工具、资源或提示。

特性

• 文档生成： 从 AI 驱动的提示生成 PDF、Word、PowerPoint 和 Excel 文件。
• 图片嵌入与缩放： 在 DOCX 和 PPTX 文件中插入和调整大小图片。
• 异步处理： 使用 BullMQ 和 Redis 排队并处理文档生成任务。
• 验证： 通过捕获和分析截图来验证文档布局。
• API 首要： 提供 RESTful 端点用于文档生成、任务状态检查和结果下载。
• 可扩展性： 模块化架构，便于添加新的文件类型或工具。

项目结构

src/
  app.js
  server.js
  config/
  controllers/
  middleware/
  public/
  routes/
  services/
  utils/
  workers/
temp_image/
validation-screenshots/
test-output/

快速入门

先决条件

• Node.js（建议版本 v14+）
• Redis 服务器

安装

1. 克隆仓库：

   git clone <repository-url>
   cd mcp-server
   

2. 安装依赖项：

   npm install
   

3. 设置环境变量：
   • 复制 .env.example 为 .env，并填写所需的值。

运行服务器

npm start

运行测试

npx jest src/services/fileCreation.test.js --runInBand

API 端点

• POST /documents/generate — 请求文档生成（PDF、DOCX、PPTX、XLSX）
• GET /documents/generate/status/:jobId — 检查任务状态
• GET /documents/generate/result/:jobId — 下载生成的文件

文件生成与验证

• 支持通过 Gemini/OpenAI 函数调用实现 AI 驱动的内容和布局。
• DOCX 和 PPTX 中支持图片插入及缩放功能。
• 布局验证使用截图（模拟或真实，见 aiFileValidationService）。

使用方法

构建与启动

npm run build
npm start

MCP 主机配置示例（stdio）

在你的主机的 mcp.json 中添加：

{
  "servers": {
    "your-server-name": {
      "type": "stdio",
      "command": "node",
      "args": ["server.js"]
    }
  }
}

验证连接

运行以下命令以验证与 MCP 服务器的连接：

mcp ls
mcp info your-server-name

注意事项

• 确保 Redis 服务器已正确安装并运行。
• 在生产环境中，建议使用 HTTPS 并启用身份验证来保护 API 端点。
• 对于大规模任务处理，请根据需要优化 BullMQ 和 Redis 的性能参数。

通过以上步骤，您可以轻松设置和运行一个符合 MCP 协议的文档生成服务器，并与各种 AI 主机集成。