plan-export MCP server
Commit Nov 5, 2026Converts Markdown implementation plans and Mermaid diagrams into high-resolution PNGs, PDFs, and standalone HTML files.
Also known as agmonetti/plan-export-mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 5, 2026
- License
- MIT
What is plan-export MCP?
plan-export converts Markdown implementation plans and Mermaid diagrams into high-resolution PNGs, PDFs, and standalone HTML files.
Summary generated from the project's README
About plan-export MCP server
Converting Markdown implementation plans and Mermaid diagrams into professional visual documents is what plan-export-mcp enables for developers using AI coding agents. When tools like Cursor, Claude Code, or Windsurf generate technical plans, this server allows them to export those plans as high-resolution PNGs, print-optimized A4 PDFs, or standalone HTML files. This prevents the loss of formatting and dark themes that often occurs when sharing raw Markdown via Slack or email.
Users can run this as a local MCP server via npx or install it globally using npm. It requires Node.js 20 or higher and uses Puppeteer to manage a headless browser for rendering. The engine utilizes Shiki for VS Code-style code highlighting and supports GitHub-style callouts like NOTE or WARNING. It is designed to handle complex technical content, including Mermaid architecture diagrams and code diffs, ensuring that visual fidelity is maintained across different file formats.
What you can do with it
- 1Shareable chat snapshotsGenerate a high-resolution 2x Retina PNG of a technical plan to send directly into Slack or WhatsApp.
- 2Professional documentation exportsCreate a clean, print-ready A4 PDF that preserves background colors and dark mode themes for formal reviews.
- 3Offline technical manualsProduce a standalone HTML file containing embedded styles for viewing technical documentation without an internet connection.
Written from the project's README. Every use case is checked against a quote from it.
Configuration
PUPPETEER_EXECUTABLE_PATH
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableagmonetti/plan-export-mcp is public and reachablegithub.com/agmonetti/plan-export-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-05github.com/agmonetti/plan-export-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubplan-export-mcp
The visual export engine for coding agents. Turn Markdown plans and Mermaid diagrams into beautiful, shareable documents.
The Problem
When coding agents (Cursor, Claude Code, Pi, Windsurf, Aider) draft implementation plans or audit codebases, they generate rich Markdown with code diffs, Mermaid architecture diagrams, GitHub callouts, and task lists.
- Inside your IDE: It looks crisp and structured.
- When sharing: Sending raw
.mdon WhatsApp, Slack, or Email turns into an unreadable mess. Generic PDF converters output 1990s-style plain black-and-white academic papers, break Mermaid diagrams, and strip dark themes.
plan-export-mcp bridges this gap. It gives your AI agent a native MCP tool to export plans with pixel-perfect visual fidelity.
Key Features
- High-Res PNG (Long Screenshot): Rendered at 2x Retina DPR. Ideal for WhatsApp and Slack because it renders inline in chat feeds without forcing teammates to download a PDF reader.
- VS Code Code Highlighting: Powered by Shiki with language badges and diff support (
+/-lines). - GitHub Callouts & Alerts: Native support for
> [!NOTE],> [!WARNING],> [!TIP],> [!IMPORTANT], and> [!CAUTION]. - Technical Typography: Visible Markdown prose uses Unicode arrows, comparisons, plus/minus, and ellipses while code, autolinks, HTML, and Mermaid stay unchanged.
- Private Artifact References:
file://,vscode://,cursor://, andwindsurf://links render only their labels as inline code, without exposing local paths. - Mermaid Architecture Diagrams: Client-side vector rendering directly embedded as SVG.
- Clean A4 PDF: Print-optimized with background colors and screen contrast preserved.
- Standalone HTML: Embedded styles; Mermaid diagrams load a pinned CDN script, and HTTPS images remain external. Fully offline viewing requires no Mermaid diagrams or external images.
- Dual Mode: Use it as an MCP server for AI agents or as a standalone CLI tool.
Installation and Usage
Prerequisites
- Node.js 20+
- npm, pnpm, or yarn
(Note: HTML exports run in pure Node.js with zero browser dependencies. For PDF/PNG rendering, Puppeteer manages a lightweight headless browser automatically or uses system Chromium if present).
1. Run with NPX (Recommended)
Runs on-demand without any global installation.
Claude Code (One-liner CLI)
claude mcp add plan-export npx -y @agmonetti/plan-export-mcp
Claude Desktop & Cursor (JSON Configuration)
Add to your claude_desktop_config.json or .cursor/mcp.json:
{
"mcpServers": {
"plan-export": {
"command": "npx",
"args": ["-y", "@agmonetti/plan-export-mcp"]
}
}
}
Tip (Linux/Docker): If Puppeteer cannot locate Chrome automatically, specify its path explicitly:
"env": { "PUPPETEER_EXECUTABLE_PATH": "/usr/bin/google-chrome-stable" }
2. Install Globally from NPM
Ideal for instant startup without network latency on every invocation:
npm install -g @agmonetti/plan-export-mcp
{
"mcpServers": {
"plan-export": {
"command": "plan-export-mcp"
}
}
}
3. Install from Source (Development)
Clone the repository and build locally:
git clone https://github.com/agmonetti/plan-export-mcp.git
cd plan-export-mcp
npm install
npm run build
{
"mcpServers": {
"plan-export": {
"command": "node",
"args": ["/path/to/plan-export-mcp/dist/index.js"]
}
}
}
Standalone CLI Usage
You can also run it directly in your terminal:
# Export to PNG and PDF in dark mode
npx @agmonetti/plan-export-mcp docs/plan.md --theme dark
# Export to all formats in light mode
npx @agmonetti/plan-export-mcp docs/plan.md --theme light --formats png,pdf,html --output-dir exports/
MCP Tool Reference: export_plan
Your AI agent can invoke this tool directly:
{
"input": "docs/plans/feature-auth.md", // or raw markdown string
"theme": "dark", // "dark" | "light" (default: "light")
"formats": ["png", "pdf"], // ["png", "pdf", "html"]
"outputDir": "./exports", // default: "./exports"
"outputName": "auth-plan" // default: derived from file
}
Remote images are format-dependent: standalone HTML may load HTTPS images from the viewer's network, while PNG/PDF browser rendering blocks external images. The browser permits the pinned Mermaid CDN script as a fallback if the bundled script is unavailable. Use embedded data: images for portable exports; local file URLs are not loaded.
Input files may be reached through symlinks to permitted targets. Path validation assumes a trusted local filesystem: it does not protect against another local process replacing files or directory entries concurrently between path resolution and opening. Do not accept input paths in directories an untrusted local user can modify.
Architecture
- Runtime: Node.js (>= 20) + TypeScript
- MCP SDK:
@modelcontextprotocol/sdk(stdio transport) - Highlighter: Shiki (VS Code TextMate engine)
- Diagrams: Mermaid.js
- Headless Engine: Puppeteer with intelligent fallback to system Chrome/Chromium.
License
MIT © 2025
plan-export MCP questions
Does it support Mermaid diagrams?
Yes, it provides client-side vector rendering for Mermaid architecture diagrams embedded as SVG.
How do I use it with Claude Desktop or Cursor?
You can add it to your configuration files using npx by adding the server definition to your claude_desktop_config.json or .cursor/mcp.json.
Can I use it without installing it globally?
Yes, you can run it on-demand using npx without any global installation.