MCP 服务器 (符合 MCP 协议)

概述

此服务器现在是一个符合标准的 模型上下文协议 (MCP) 服务器。它将文档生成作为 MCP 工具公开，允许通过 MCP 协议与 AI 主机（例如，Copilot、Cursor、Claude Desktop）集成。

MCP 功能

• MCP 工具： generateDocument — 从提示生成 PDF、DOCX、PPTX 或 XLSX 文件。
• 传输： Stdio（本地，默认）。如果需要，可以添加 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）。

示例：图像嵌入和调整大小

• 将图像放置在 temp_image/ 中（例如，temp_image/blackboard-with-camera-leaf.jpg）。
• 使用如下函数调用：

  { name: 'addImage', arguments: { path: 'temp_image/blackboard-with-camera-leaf.jpg', options: { width: 150, height: 150 } } }
  

用法

构建和启动

npm run build
npm start

MCP 主机配置示例 (stdio)

添加到您的主机的 mcp.json（例如，对于 Cursor、VS Code、Claude Desktop）：

{
  "mcpServers": {
    "document-server": {
      "command": "/usr/local/bin/node",
      "args": ["/absolute/path/to/build/index.js"]
    }
  }
}

使用 MCP Inspector 调试

您可以使用官方 MCP Inspector 测试此服务器：

npx @modelcontextprotocol/inspector node build/index.js

扩展

• 使用 MCP SDK 在 src/index.ts 中添加更多工具/资源。
• 对于 SSE/网络传输，请参阅 MCP SDK 文档和指南。

安全与最佳实践

• 始终验证和清理工具/资源输入。
• 未经用户同意，切勿暴露敏感数据。
• 对于远程/SSE 部署，请实施身份验证和 TLS。

贡献

欢迎贡献！请打开一个 issue 或提交一个 pull request。

许可证

MIT

---

此项目现在遵循 Node.js/Typescript 的官方 MCP 服务器标准。