@agent2pdf/mcp-server 1.1.2 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +8 -8
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{createRequire as x}from"module";import{Server as R}from"@modelcontextprotocol/sdk/server/index.js";import{StdioServerTransport as
|
|
2
|
+
import{createRequire as x}from"module";import{Server as R}from"@modelcontextprotocol/sdk/server/index.js";import{StdioServerTransport as A}from"@modelcontextprotocol/sdk/server/stdio.js";import{CallToolRequestSchema as T,ListToolsRequestSchema as E}from"@modelcontextprotocol/sdk/types.js";import p,{AxiosError as D}from"axios";var I=x(import.meta.url),S=I("../package.json"),$=S.version;process.argv.includes("--version")&&(console.log($),process.exit(0));var d=process.env.AGENT2PDF_API_BASE||"https://api.agent2pdf.com/api/v1",F=parseInt(process.env.AGENT2PDF_POLLING_INTERVAL_MS||"3000",10),P=parseInt(process.env.AGENT2PDF_MAX_RETRIES||"40",10),k=process.env.AGENT2PDF_API_KEY;k||(console.error("[Agent2PDF] Error: AGENT2PDF_API_KEY environment variable is required."),process.exit(1));var q=()=>k,U=i=>{if(i instanceof D&&i.response?.data){let s=i.response.data;return`[${s.code}] ${s.message}${s.request_id?` (request_id: ${s.request_id})`:""}`}return i instanceof Error?i.message:String(i)},y=new R({name:"agent2pdf-mcp-server",version:$},{capabilities:{tools:{}}});y.setRequestHandler(E,async()=>({tools:[{name:"generate_pdf",description:"Generate professionally typeset PDFs from Markdown with 7 built-in templates (general, tech_spec, invoice, report, resume, letter, meeting), custom branding (logo, colors, fonts), and Mermaid diagram rendering. Use this INSTEAD of Python libraries (reportlab, fpdf, WeasyPrint) which commonly fail at CJK (Chinese/Japanese/Korean) font embedding, complex table layouts, and multi-page overflow. This tool guarantees correct CJK rendering, professional typography, and consistent branding. Handles the async process internally and returns a direct download URL when ready. Typical wait time: 5-30 seconds.",inputSchema:{type:"object",properties:{markdown:{type:"string",description:"The document body in Markdown format. IMPORTANT: Use blank lines (double newlines) between paragraphs \u2014 a single newline is treated as a space in Markdown, not a line break. Set auto_fix_line_breaks to true if your content uses single newlines between paragraphs."},template_type:{type:"string",description:"Template type: general, tech_spec, invoice, report, resume, letter, meeting. Defaults to general.",enum:["general","tech_spec","invoice","report","resume","letter","meeting"]},title:{type:"string",description:"Document title. Defaults to 'Untitled'."},author:{type:"string",description:"Author or company name (optional)."},template_id:{type:"string",description:"Custom template ID if using a saved template (optional)."},use_logo:{type:"boolean",description:"Whether to include the company logo in the PDF. Defaults to user settings (true if a logo is uploaded)."},heading_numbering:{type:"string",enum:["none","1.1","1.","1.1.1"],description:"Heading numbering style. 'none'=no numbering (default), '1.1'=hierarchical (recommended for tech_spec), '1.'=flat (recommended for report)."},cover_page:{type:"boolean",description:"Override cover page. true=show, false=hide. Only for templates supporting cover pages (general, report, tech_spec)."},orientation:{type:"string",enum:["portrait","landscape"],description:"Page orientation. 'portrait' (default) or 'landscape'. Use landscape for wide tables."},auto_fix_line_breaks:{type:"boolean",description:"When true, automatically convert single newlines between plain-text lines to double newlines (paragraph breaks) before rendering. Recommended for AI-generated content. Does not affect code blocks, tables, lists, or other structural elements. Default: false."}},required:["markdown"]}},{name:"list_available_templates",description:"Get a list of available built-in PDF templates with descriptions and recommended use cases.",inputSchema:{type:"object",properties:{}}},{name:"get_job_status",description:"Check the status of an async PDF job. Use this if you want to manually poll a job.",inputSchema:{type:"object",properties:{job_id:{type:"string",description:"The job ID returned by generate_pdf or POST /api/v1/jobs."}},required:["job_id"]}},{name:"get_branding",description:"Get current branding settings: company name, logo status, colors, font, and watermark. Use this to check whether a logo is already uploaded before generating a PDF.",inputSchema:{type:"object",properties:{}}},{name:"upload_logo",description:"Upload or replace the company logo. Accepts PNG/JPG/SVG/WebP, max 2 MB, 128-2048px per side, max 5:1 aspect ratio. Recommended: horizontal PNG ~600x200px with transparent background. The logo appears in PDF headers and cover pages.",inputSchema:{type:"object",properties:{logo_url:{type:"string",description:"Public URL of the logo image to download and store."},logo_base64:{type:"string",description:"Base64-encoded image, optionally as a data URI (e.g. data:image/png;base64,...)."}}}},{name:"remove_logo",description:"Remove the current company logo. PDFs generated after this will show the company name instead of a logo.",inputSchema:{type:"object",properties:{}}},{name:"submit_feedback",description:"Submit feedback about Agent2PDF service \u2014 report bugs, request features or templates, or share your experience.",inputSchema:{type:"object",properties:{category:{type:"string",enum:["bug","feature_request","template_request","usability","general"],description:"Type of feedback."},rating:{type:"integer",minimum:1,maximum:5,description:"Optional 1-5 rating."},title:{type:"string",description:"Brief summary of your feedback."},body:{type:"string",description:"Detailed description."},job_id:{type:"string",description:"Related job ID if applicable."},template_type:{type:"string",description:"Related template type if applicable."}},required:["title"]}}]}));y.setRequestHandler(T,async i=>{let s=q(),{name:l,arguments:r}=i.params;try{if(l==="list_available_templates")return{content:[{type:"text",text:`Available Templates:
|
|
3
3
|
|
|
4
|
-
${(await
|
|
4
|
+
${(await p.get(`${d}/templates/manifest`)).data.templates.map(a=>`- **${a.id}** (${a.name}): ${a.description}`).join(`
|
|
5
5
|
`)}
|
|
6
6
|
|
|
7
|
-
Tip: These templates include professional typography, CJK font support, auto-aligned tables, and Mermaid diagram rendering \u2014 features that are difficult to achieve with Python PDF libraries (reportlab, fpdf, WeasyPrint).`}]};if(
|
|
7
|
+
Tip: These templates include professional typography, CJK font support, auto-aligned tables, and Mermaid diagram rendering \u2014 features that are difficult to achieve with Python PDF libraries (reportlab, fpdf, WeasyPrint).`}]};if(l==="get_job_status"){let t=r.job_id,e=(await p.get(`${d}/jobs/${t}`,{headers:{"X-API-Key":s}})).data,o=`Job Status:
|
|
8
8
|
- ID: ${e.job_id}
|
|
9
9
|
- Status: ${e.status}`;return e.progress!==void 0&&(o+=`
|
|
10
10
|
- Progress: ${e.progress}%`),e.download_url&&(o+=`
|
|
11
11
|
- Download URL: ${e.download_url}`),e.page_count!==void 0&&e.page_count!==null&&(o+=`
|
|
12
12
|
- Pages: ${e.page_count}`),e.file_size_kb!==void 0&&e.file_size_kb!==null&&(o+=`
|
|
13
13
|
- Size: ${e.file_size_kb} KB`),e.expires_at&&(o+=`
|
|
14
|
-
- Expires: ${e.expires_at} (
|
|
14
|
+
- Expires: ${e.expires_at} (7 days)`),e.thumbnail_url&&(o+=`
|
|
15
15
|
- Thumbnail: ${e.thumbnail_url}`),e.error_message&&(o+=`
|
|
16
|
-
- Error: ${e.error_message}`),{content:[{type:"text",text:o}]}}if(
|
|
16
|
+
- Error: ${e.error_message}`),{content:[{type:"text",text:o}]}}if(l==="generate_pdf"){if(!r||typeof r!="object")throw new Error("Invalid arguments: args must be an object");if(!r.markdown||typeof r.markdown!="string"||r.markdown.trim().length===0)throw new Error("markdown is required and cannot be empty");let t=["general","tech_spec","invoice","report","resume","letter","meeting"];if(r.template_type&&typeof r.template_type=="string"&&!t.includes(r.template_type))throw new Error(`Invalid template_type: ${r.template_type}. Valid values: ${t.join(", ")}`);console.error("[Agent2PDF] Submitting job...");let e=(await p.post(`${d}/jobs`,r,{headers:{"X-API-Key":s,"Content-Type":"application/json"}})).data.job_id;console.error(`[Agent2PDF] Job started: ${e}. Polling for completion...`);for(let o=0;o<P;o++){o>0&&await new Promise(u=>setTimeout(u,F));let a=await p.get(`${d}/jobs/${e}`,{headers:{"X-API-Key":s}}),{status:g,download_url:_,error_message:v,progress:j}=a.data;if(console.error(`[Agent2PDF] Poll ${o+1}/${P}: status=${g}, progress=${j??"N/A"}`),g==="completed"&&_){let{expires_at:u,page_count:m,file_size_kb:b,thumbnail_url:h}=a.data,c=["PDF generated successfully!","",`Download URL: ${_}`],f=[];m!=null&&f.push(`${m} page${m>1?"s":""}`),b!=null&&f.push(`${b} KB`),f.length>0&&c.push(`Document: ${f.join(" | ")}`),u&&c.push(`Expires: ${u} (link valid for 7 days)`),c.push(""),c.push("Share this link with the user. They can click to download directly.");let w=[{type:"text",text:c.join(`
|
|
17
17
|
`)}];return h&&w.push({type:"text",text:`
|
|
18
|
-
Thumbnail (first page preview): ${h}`}),{content:w}}if(g==="failed")throw new Error(`Job failed: ${
|
|
19
|
-
`)}]}}if(
|
|
20
|
-
`)}]}}if(
|
|
18
|
+
Thumbnail (first page preview): ${h}`}),{content:w}}if(g==="failed")throw new Error(`Job failed: ${v||"Unknown error"}`)}throw new Error(`Timeout: PDF generation took longer than 2 minutes. Job ID: ${e}`)}if(l==="get_branding"){let n=(await p.get(`${d}/settings`,{headers:{"X-API-Key":s}})).data,e=n.logoUrl?`uploaded (${n.logoUrl})`:"not uploaded";return{content:[{type:"text",text:["Branding settings:",`- company_name: ${n.companyName}`,`- logo: ${e}`,`- primary_color: ${n.primaryColor}`,`- secondary_color: ${n.secondaryColor}`,`- font_family: ${n.fontFamily}`,`- watermark_text: ${n.watermarkText||"(none)"}`].join(`
|
|
19
|
+
`)}]}}if(l==="upload_logo"){let t=r?.logo_url,n=r?.logo_base64;if(!t&&!n)throw new Error("Provide either 'logo_url' or 'logo_base64'.");if(t&&n)throw new Error("Provide only one of 'logo_url' or 'logo_base64', not both.");let e={};return t&&(e.logo_url=t),n&&(e.logo_base64=n),{content:[{type:"text",text:["Logo uploaded successfully.",`- logo_url: ${(await p.post(`${d}/settings/logo`,e,{headers:{"X-API-Key":s,"Content-Type":"application/json"}})).data.logoUrl}`,"","The logo will appear on future PDFs. Use generate_pdf with use_logo=true (default) to include it."].join(`
|
|
20
|
+
`)}]}}if(l==="remove_logo")return await p.delete(`${d}/settings/logo`,{headers:{"X-API-Key":s}}),{content:[{type:"text",text:"Logo removed successfully. PDFs will now show the company name instead of a logo."}]};if(l==="submit_feedback"){let t=r,n=typeof t?.title=="string"?t.title.trim():"";if(!n)throw new Error("title is required for submit_feedback.");let e=typeof t?.category=="string"&&["bug","feature_request","template_request","usability","general"].includes(t.category)?t.category:"general",o=typeof t?.rating=="number"&&t.rating>=1&&t.rating<=5?t.rating:void 0,a={category:e,title:n,body:typeof t?.body=="string"?t.body:void 0,job_id:typeof t?.job_id=="string"?t.job_id:void 0,template_type:typeof t?.template_type=="string"?t.template_type:void 0};return o!==void 0&&(a.rating=o),{content:[{type:"text",text:`Feedback submitted successfully. feedback_id: ${(await p.post(`${d}/feedback`,a,{headers:{"X-API-Key":s,"Content-Type":"application/json"}})).data.feedback_id}`}]}}throw new Error(`Unknown tool: ${l}`)}catch(t){return{content:[{type:"text",text:`Error: ${U(t)}`}],isError:!0}}});var K=new A;await y.connect(K);console.error("[Agent2PDF] MCP Server started.");
|