PDF生成服务

mcp服务器pdfnoodle

MCP服务器，使AI助手能够通过以下方式生成PDF文档 pdf面条 -使用自然语言从模板或原始HTML创建PDF。

什么是pdf面条？

pdf面条是一个pdf生成的API，可以让你：

• 使用AI创建可重复使用的PDF模板
• 通过用数据填充模板生成PDF
• 将HTML直接转换为PDF

安装

克劳德桌面

添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pdfnoodle": {
      "command": "npx",
      "args": ["-y", "mcp-server-pdfnoodle"],
      "env": {
        "PDFNOODLE_API_KEY": "your-api-key"
      }
    }
  }
}

光标

增添 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "pdfnoodle": {
      "command": "npx",
      "args": ["-y", "mcp-server-pdfnoodle"],
      "env": {
        "PDFNOODLE_API_KEY": "your-api-key"
      }
    }
  }
}

手动执行

PDFNOODLE_API_KEY=your-key npx mcp-server-pdfnoodle

远程使用

此MCP服务器也可以通过HTTP远程使用，使其与ChatGPT和n8n等工作流自动化工具兼容。

远程服务器URL

远程MCP服务器端点为：

https://mcp.pdfnoodle.com/mcp?api_key={your-api-key}

认证：无（API密钥仅通过URL查询参数传递，不需要身份验证头）

与ChatGPT一起使用

要将此MCP服务器与ChatGPT一起使用，请将其配置为自定义GPT或通过MCP设置：

1. 获取API密钥 从 pdf面条
2. 配置MCP服务器 使用远程URL：
   复制

   https://mcp.pdfnoodle.com/mcp?api_key=your-api-key
   

3. ChatGPT将能够通过远程服务器使用所有可用的pdf面条工具

备注：替换 your-api-key 在URL中使用您的实际pdf面条API键。

与n8n一起使用

您可以使用HTTP请求节点将pdf面条MCP服务器集成到n8n工作流中：

1. 创建HTTP请求节点 在n8n工作流中

2. 配置节点:

   • 方法: POST
   • 统一资源定位符: https://mcp.pdfnoodle.com/mcp?api_key=your-api-key
   • 认证：无（API键在URL查询参数中）
   • 标头:
     复制

     Content-Type: application/json
     

   • 身体：用于MCP协议调用的JSON-RPC 2.0格式

3. 请求正文示例 用于生成PDF：

   复制

   {
     "jsonrpc": "2.0",
     "id": 1,
     "method": "tools/call",
     "params": {
       "name": "generate_pdf",
       "arguments": {
         "templateId": "template-id",
         "data": "{\"field\": \"value\"}"
       }
     }
   }
   

4. 请求正文示例 用于将HTML转换为PDF：

   复制

   {
     "jsonrpc": "2.0",
     "id": 1,
     "method": "tools/call",
     "params": {
       "name": "html_to_pdf",
       "arguments": {
         "html": "<h1>Hello World</h1>",
         "pdfParams": "{\"format\": \"A4\"}"
       }
     }
   }
   

安全说明：将API密钥安全地存储在n8n凭据或环境变量中，而不是将其硬编码在URL中。

获取API密钥

1. 首选 pdf面条
2. 创建帐户或登录
3. 导航到API设置以获取密钥

可用工具

模板操作

PDF生成

PDF实用程序

PDF最佳实践

重要： 使用前 html_to_pdf 工具，AI代理应该遵循 PDF最佳实践 指导方针。

安装技能：

npx skills add pdfnoodle/pdf-best-practices

或者通过npm：

npm install pdf-best-practices

该技能包括：

• 纸张设置：A4尺寸，40px边距
• 分页符控制：防止内容笨拙地中断
• 内容物密度：避免页面稀疏
• 表格：使用d/tbody进行正确格式化
• 图像：固定尺寸，尺寸合适
• 颜色: -webkit-print-color-adjust: exact
• 文档类型：发票、报告、证书、信函模板

使用示例

配置后，您可以使用自然语言与pdf面条进行交互：

创建模板：

使用公司徽标、账单详细信息、行项目表和付款条件创建专业发票模板

生成PDF：

使用模板abc123生成包含以下数据的发票PDF：公司名称“Acme Inc”，发票编号1001，项目：小工具（50美元），服务（100美元）

将HTML转换为PDF（推荐工作流程）：

“将此报告转换为格式良好的PDF”

AI将自动：

1. 参考 PDF最佳实践 指南
2. 使用分页符控件、适当的边距和优化的布局创建结构正确的HTML
3. 呼叫 html_to_pdf A4纸和40px边距的正确pdfParams

快速HTML转换：

“将此HTML转换为PDF： <h1>Hello World</h1><p>This is a test document</p>"

工具参数

generate.pdf

{
  "templateId": "template-id",
  "data": "{\"field\": \"value\"}",
  "convertToImage": false,
  "hasCover": false
}

html_to_pdf

{
  "html": "<html>...</html>",
  "pdfParams": "{\"format\": \"A4\", \"margin\": {\"top\": \"1cm\"}}",
  "convertToImage": false
}

create_template_with_ai

{
  "displayName": "My Template",
  "prompt": "A detailed description of the template design...",
  "fileUrl": "https://example.com/reference.pdf"
}

发展

# Clone the repository
git clone https://github.com/pdfnoodle/mcp-server-pdfnoodle.git
cd mcp-server-pdfnoodle

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
PDFNOODLE_API_KEY=your-key npm run dev

许可证

麻省理工学院-见 许可证

更新日志

链接

• pdf面条 -PDF生成平台
• pdf面条API文档 -API文件
• PDF最佳实践 -HTML到PDF转换指南
• MCP协议 -模型上下文协议规范