Hosted on GitHub as a repository for source code and issue tracking
Built using JavaScript/TypeScript and provides direct access to PDFKit's JavaScript API for advanced PDF generation capabilities
Runs on Node.js runtime environment and is distributed as a Node.js package
Published and distributed through npm package registry for easy installation and dependency management
Provides TypeScript interfaces and examples for type-safe PDF generation and content structuring
Provides full Unicode text support for international languages including CJK, Arabic, Cyrillic, Hebrew, Thai and other scripts in PDF generation
@mcp-z/mcp-pdf
MCP server for creative PDF generation. AI agents and users work together to create anything from simple documents to artistic masterpieces—all powered by PDFKit.
Why This Exists
PDFs shouldn't be boring. This server gives AI agents the power to generate professional documents, creative projects, and everything in between. Color emoji support (😀 🎉 🚀), full Unicode (你好 مرحبا Привет), and direct PDFKit access mean the only limit is imagination.
Projects range from Bob Ross-style paintings and space-themed documents to practical invoices and resumes. It's for professionals and fun seekers alike.
Features
Creative Freedom - Colors, shapes, positioning, emoji—build anything
Pure JavaScript - No native dependencies, works everywhere
Emoji & Unicode - Color emoji as images, full international text support
Three Tools - Simple text, advanced layouts, or JSON Resume format
PDFKit Wrapper - Minimal abstraction over PDFKit's powerful API
Installation
Or use directly:
Quick Start
Add to claude_desktop_config.json
:
Security Model
This server writes PDFs to a sandboxed directory to prevent path traversal attacks:
Default location:
~/.mcp-pdf/
Custom location: Set
PDF_OUTPUT_DIR
environment variableFilename sanitization: Blocks
..
,/
, and unsafe charactersNo path parameters: Tools accept only filenames, not full paths
All generated PDFs are written to the configured output directory with sanitized filenames.
Custom Output Directory
To override the default location, set the PDF_OUTPUT_DIR
environment variable:
Where to Find This Server
Published on multiple MCP registries and package managers:
npm -
@mcp-z/mcp-pdf
MCP Official Registry -
io.github.kmalakoff/mcp-pdf
Smithery - One-click install via Smithery CLI
Awesome MCP Servers - Community curated list (pending approval)
Cline Marketplace - Built-in to Cline IDE (coming soon)
GitHub Repository - Source code and issues
What You Can Create
Professional - Resumes, invoices, reports, certificates
Creative - Flyers, posters, artistic documents, themed designs
Practical - Letters, notices, forms, documentation
Experimental - Bob Ross paintings, space themes, progressive effects
Anything - If it's a PDF, you can build it
Examples
1. Simple Text Document
Start simple with plain text:
2. Styled Document with Colors
Add visual style with colors and formatting:
3. Certificate with Shapes
Combine shapes and text for visual impact:
4. Professional Resume
Handle complex structured data with JSON Resume:
Creative Possibilities
This tool has been used to create:
Bob Ross-style paintings - Layered shapes with colors creating landscape art
Space-themed documents - Stars, gradients, and cosmic effects
Apartment notices - Creative community announcements with visual flair
Progressive effects - Font tapering, color gradients, animated-style layouts
The examples above show practical starting points, but agents can combine shapes, colors, positioning, and text to create virtually anything. The create-pdf
tool provides direct access to PDFKit's capabilities.
Available Tools
generate-resume-pdf
Generate professional resumes from JSON Resume format.
Parameters:
filename
(string, optional) - Filename for the PDF (defaults to "resume.pdf")resume
(object, required) - JSON Resume schema
Resume Schema Sections:
basics
- Name, contact, summary, locationwork
- Work experience with highlightseducation
- Degrees and institutionsprojects
- Personal/professional projectsskills
- Skills grouped by categoryawards
,certificates
,languages
,volunteer
,publications
,interests
,references
See the resume example above for structure.
create-simple-pdf
Create basic text PDFs quickly.
Parameters:
filename
(string, optional) - Filename for the PDF (defaults to "document.pdf")text
(string, required) - Text contenttitle
(string, optional) - Document metadata title
create-pdf
Advanced PDF creation with full layout control.
Parameters:
filename
(string, optional) - Filename for the PDF (defaults to "document.pdf")title
(string, optional) - Document metadataauthor
(string, optional) - Document metadatapageSetup
(object, optional) - Page configurationcontent
(array, required) - Content items
Page Setup:
Content Types:
Text & Headings:
Shapes:
Images & Pages:
Emoji & Unicode Support
Color Emoji ✅
True color emoji render as inline PNG images:
Emoji like 😀 🎉 🚀 👋 appear in full color. The emoji font (NotoColorEmoji.ttf) downloads automatically on install.
Unicode ✅
Full international text support:
CJK: Chinese (你好), Japanese (こんにちは), Korean (안녕하세요)
Scripts: Arabic (مرحبا), Cyrillic (Привет), Hebrew, Thai
Symbols: Greek (Ξ Δ Ω), geometric (△ ○ ◆), dingbats (✓ ✗ ➤)
Resources
PDFKit Documentation - Full PDFKit API reference
JSON Resume Schema - Resume format documentation
JSON Resume Editor - Online resume builder
Requirements
Node.js >= 16
License
MIT
Development & Deployment
Publishing a New Version
Two-command deployment:
This script automatically:
✅ Builds the package
✅ Publishes to npm
✅ Pushes to GitHub
✅ Updates MCP Official Registry
Manual submissions after deployment:
🔲 Smithery: https://smithery.ai/new (if major changes)
🔲 mcpservers.org: https://mcpservers.org/submit (one-time)
Automatic updates (no action needed):
⏳ PulseMCP: Auto-discovers from npm within 24-48 hours
Registry Status
Check where the package is published:
MCP Official: https://modelcontextprotocol.io/registry
GitHub: https://github.com/mcp-z/mcp-pdf
PulseMCP: https://www.pulsemcp.com/servers
Awesome MCP: https://mcpservers.org/
local-only server
The server can only run on the client's local machine because it depends on local resources.
Enables creative PDF generation with full design control including colors, shapes, emoji, and Unicode support. Supports everything from simple documents to artistic masterpieces using PDFKit's powerful API.