English Français العربية

io.github.themoddedcube/pdf-report-generator

Official registry Productivity

Generate professional PDF reports from LLM output — cover, TOC, tables, charts, 5 themes.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @ctalasila/pdf-report-generator
Claude Code 
claude mcp add pdf-report-generator -- npx -y @ctalasila/pdf-report-generator@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pdf-report-generator": {
            "command": "npx",
            "args": [
                "-y",
                "@ctalasila/pdf-report-generator@1.0.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. pdf-report-generator
  2. Prerequisites
  3. Claude Desktop configuration
  4. Available tools
  5. JSON spec reference
  6. Example prompts
  7. Troubleshooting
  8. License

pdf-report-generator

An MCP server that generates professional corporate PDF reports from structured JSON specs or raw LLM text output. Drop it into Claude Desktop (or any MCP client) and ask Claude to turn analysis, research, or meeting notes into a polished multi-page report complete with cover page, table of contents, executive summary, section headings, tables, and charts.

A sample output is at examples/sample_report.pdf.

Prerequisites

  • Node.js 18+
  • Python 3.8+

Install Python dependencies:

pip install reportlab matplotlib

Claude Desktop configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "pdf-report": {
      "command": "npx",
      "args": ["-y", "pdf-report-generator"]
    }
  }
}

Available tools

generate_report

Generates a PDF from a full structured spec.

Minimal example input:

{
  "spec": {
    "metadata": {
      "title": "Q3 Performance Review",
      "author": "Engineering Team",
      "company": "Acme Corp",
      "classification": "INTERNAL"
    },
    "executive_summary": "Overall performance improved this quarter...",
    "sections": [
      {
        "heading": "Infrastructure",
        "body": "Uptime reached 99.94%...",
        "subsections": []
      }
    ],
    "tables": [],
    "charts": []
  }
}
generate_report_from_text

Converts raw text into a structured PDF report. Sections are auto-detected from headings.

{
  "text": "# Overview\nThis quarter...\n\n# Key Findings\n...",
  "title": "Q3 Summary",
  "author": "Data Team",
  "company": "Acme Corp",
  "classification": "INTERNAL",
  "theme_name": "navy"
}
list_themes

Returns available color themes: default, navy, charcoal, forest, burgundy.

JSON spec reference

metadata
  title*          string
  subtitle        string
  author          string
  date            string (YYYY-MM-DD; defaults to today)
  company         string
  department      string
  document_id     string  (e.g. RPT-2026-001)
  classification  string  (PUBLIC | INTERNAL | CONFIDENTIAL)
  logo_path       string  (absolute path to PNG/JPG)
  page_size       "letter" | "a4"

executive_summary  string

sections[]
  heading*        string
  body*           string  (\n\n = paragraph break)
  subsections[]
    heading*      string
    body*         string

tables[]
  title           string
  headers*        string[]
  rows*           string[][]
  after_section   int  (0-based section index; -1 = after exec summary)

charts[]
  title           string
  type            "bar" | "line" | "pie" | "horizontal_bar"
  labels*         string[]
  datasets*       [{label, values[]}]
  after_section   int

images[]
  path*           string  (absolute path)
  caption         string
  width_inches    number
  after_section   int

theme
  primary_color    [R, G, B]
  accent_color     [R, G, B]
  highlight_color  [R, G, B]

Example prompts

  • "Turn this analysis into a professional internal PDF report titled 'Q3 Infrastructure Review'"
  • "Generate a corporate report from this research, add a bar chart for the monthly metrics"
  • "Create a CONFIDENTIAL report called 'Security Audit Findings' from this text"
  • "List the available report themes"

Troubleshooting

Python not found — ensure python or python3 is on your PATH and is version 3.8+.

reportlab not installed — run pip install reportlab matplotlib.

Charts missing — matplotlib is required for charts. Install it with pip install matplotlib.

Large PDFs — complex specs with many charts can take 5–15 seconds. This is normal.

License

MIT

Frequently asked questions

What is io.github.themoddedcube/pdf-report-generator?

Generate professional PDF reports from LLM output — cover, TOC, tables, charts, 5 themes.

How do I install io.github.themoddedcube/pdf-report-generator?

It runs on your machine. In Claude Code: claude mcp add pdf-report-generator -- npx -y @ctalasila/pdf-report-generator@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.themoddedcube/pdf-report-generator need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.themoddedcube/pdf-report-generator open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.themoddedcube/pdf-report-generator?

It is published by themoddedcube. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.