Lumin

Lumin PDF MCP 服务

Lumin PDF MCP 服务可在兼容 MCP 的 AI 助手（例如 Claude Desktop 和 Cursor）与Lumin 的 API 服务之间实现无缝集成。AI 助手可通过自然语言命令直接执行文档管理、发送签名请求、获取工作区详情和生成 PDF 等操作。

---

🚀 功能

此 MCP 服务提供以下 Lumin API 工具：

• get_lumin_user_information – 获取当前 Lumin 用户的信息。
• get_signature_request_on_lumin_by_id – 使用签名请求 ID 获取详情。
• cancel_signature_request_on_lumin_by_id – 取消待处理的签名请求。
• send_signature_request_on_lumin – 创建并发送附带文档的签名请求。
• upload_file_to_lumin – 将文件上传到 Lumin。
• get_workspace_list_of_user_on_lumin – 获取与用户关联的所有工作区。
• lumin_markdown2pdf – 通过 Lumin 将 Markdown 内容转换为 PDF。

---

📦 安装

Cursor 用户

如果你使用 Cursor，只需打开提供的集成链接，Cursor 会自动完成安装。

---

Claude Desktop 用户

将以下配置添加到 claude_desktop_config.json 文件中：

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

Windows： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "lumin": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.luminpdf.com/mcp"]
    }
  }
}

很快将支持其他 MCP 客户端。

---

🛠 故障排查

Cursor 身份验证问题

如果安装失败或 Cursor 无法进行身份验证，请尝试清除缓存的凭据：

/Users/<your-username>/.mcp-auth/

随后重启 Cursor 并重新安装集成。

---

📘 自然语言命令示例

（下文提供更完整的工作流示例。）

以下是可向启用了 MCP 的 AI 助手发出的指令示例：

获取用户信息

Get my user information from Lumin.

取消签名请求

Cancel my signature request with ID: my-signature-request-id

发送签名请求

Send a signature request with these details:
- Title: Contract Agreement
- Signers: [email protected] (John Doe), [email protected] (Mary Smith)
- Expiry: 7 days from now
- File URL: https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf

（注意：未来版本将增强对公共 URL 文档的支持。）

---

---

🔄 综合工作流示例

以下端到端工作流示例展示了 AI 助手如何组合使用所有 Lumin MCP 工具。

🔐 工作流 1：上传文档并发送签名请求

1. Get my user information from Lumin.
2. Retrieve my list of workspaces on Lumin.
3. Upload the file named "service-agreement.pdf" to my primary workspace.
4. Send a signature request using the uploaded file with:
   - Title: Service Agreement
   - Signer: [email protected] (Primary Signer)
   - Message: Please review and sign.
   - Expiry: 5 days from now

📄 工作流 2：检查状态并生成 PDF 摘要

1. Get details of my signature request with ID: req_12345.
2. Convert the following Markdown into a PDF using Lumin:
   """
   # Signature Request Summary
   - Request ID: req_12345
   - Status: <insert-status-from-response>
   - Generated: Today
   """
3. Save or download the generated summary PDF.

🚫 工作流 3：取消签名请求并验证

1. Cancel my signature request with ID: req_12345.
2. Retrieve the request again to confirm it is now cancelled.

🗂 工作流 4：管理工作区并转换文档

1. Retrieve all workspaces associated with my Lumin account.
2. Upload a file named "proposal.md" to my "Client Projects" workspace.
3. Convert the uploaded Markdown file into a PDF using Lumin.
4. Send that generated PDF as part of a signature request.

🔁 工作流 5：完整自动化链

1. Upload the document "nda.pdf" to Lumin.
2. Create a signature request using the uploaded document.
3. Periodically check the status of the request until it is completed.
4. Once completed, generate a PDF summary of the signing details using Markdown.
5. Upload the summary PDF into my workspace for archival.

---

📚 API 文档

完整参考文档请访问： 👉 https://developers.luminpdf.com/api/