
## 概述
这个n8n工作流将doqs.dev的PDF填充API转换为MCP兼容的接口,为AI代理提供完整的PDF模板管理和填充功能。
## 核心功能
### MCP服务器架构
– **MCP触发器**: 作为AI代理请求的服务器端点
– **HTTP请求节点**: 处理对https://api.doqs.dev/v1的API调用
– **AI表达式**: 通过`$fromAI()`占位符自动填充参数
– **原生集成**: 直接向AI代理返回响应
### 可用操作(14个端点)
#### Designer模块(7个操作)
– **GET /designer/templates/**: 列出模板
– **POST /designer/templates/**: 创建模板
– **POST /designer/templates/preview**: 预览模板
– **DELETE /designer/templates/{id}**: 删除模板
– **GET /designer/templates/{id}**: 获取模板详情
– **PUT /designer/templates/{id}**: 更新模板
– **POST /designer/templates/{id}/generate**: 生成PDF
#### Templates模块(7个操作)
– **GET /templates**: 列出模板
– **POST /templates**: 创建模板
– **DELETE /templates/{id}**: 删除模板
– **GET /templates/{id}**: 获取模板
– **PUT /templates/{id}**: 更新模板
– **GET /templates/{id}/file**: 获取文件
– **POST /templates/{id}/fill**: 填充模板
## AI集成特性
### 参数处理
AI代理自动提供以下参数的值:
– 路径参数和标识符
– 查询参数和过滤器
– 请求体数据
– 头部和认证信息
### 响应格式
– 原生doqs.dev PDF填充API响应
– 完整的数据结构
– 内置n8n HTTP请求错误管理
## 快速设置指南
### 部署步骤
1. **导入工作流**: 将此工作流加载到n8n实例中
2. **配置认证**: 设置API密钥凭据
– 类型:Header中的API密钥
– 密钥名称:x-api-key
3. **激活工作流**: 启用工作流以启动MCP服务器
4. **获取MCP URL**: 从MCP触发器复制webhook URL
5. **连接AI代理**: 在AI代理配置中使用MCP URL
### 使用示例
将此MCP服务器连接到任何AI代理或工作流:
– **Claude Desktop**: 将MCP服务器URL添加到配置中
– **Cursor**: 将MCP服务器SSE URL添加到配置中
– **自定义AI应用**: 使用MCP URL作为工具端点
– **API集成**: 直接HTTP调用MCP端点
## 优势特点
– **零设置**: 无需参数映射或配置
– **AI就绪**: 所有参数内置`$fromAI()`表达式
– **生产就绪**: 原生n8n HTTP请求处理和日志记录
– **可扩展**: 轻松修改或添加自定义逻辑
– **社区免费**: 2分钟内即可部署使用
## 技术节点
工作流包含以下核心节点:
– MCP Trigger节点:作为服务器端点
– 14个HTTP Request节点:处理API调用
– Sticky Note节点:提供文档和说明
– AI表达式集成:自动参数填充
这个工作流为AI代理提供了完整的PDF文档自动化处理能力,支持模板创建、管理、预览和填充等全方位操作。

评论(0)