@x12i/mdreports-mcp-server

MCP (Model Context Protocol) server for Markdown Reports Studio. Exposes render and template tools over stdio so any MCP-compatible agent can produce PDF/DOCX/PPTX/HTML reports.

Install

npm install -g @x12i/mdreports-mcp-server
npx playwright install chromium   # once, for PDF export

Cursor / Claude Desktop config

{
  "mcpServers": {
    "mdreports": {
      "command": "mdreports-mcp",
      "env": {
        "MDREPORTS_TEMPLATES_DIR": "/optional/custom/templates",
        "ANTHROPIC_API_KEY": "optional-for-create-from-image"
      }
    }
  }
}

Or via npx:

{
  "mcpServers": {
    "mdreports": {
      "command": "npx",
      "args": ["-y", "@x12i/mdreports-mcp-server"]
    }
  }
}

Tools

| Tool | Description | | --- | --- | | list_templates | List built-in and user templates | | get_template | Return a template manifest as JSON | | render_markdown_to_html | Render Markdown → HTML (inline, no file write) | | render_markdown_to_pdf | Render Markdown → PDF file; returns path + bytes | | render_markdown_to_docx | Render Markdown → DOCX file; returns path + bytes | | render_markdown_to_pptx | Render Markdown → landscape PPTX file; returns path + bytes | | create_template_from_html | Create a user template from HTML + CSS | | create_template_from_image | Create a user template from a design image (Anthropic) | | delete_template | Delete a user-created template |

PDF/DOCX/PPTX tools write to outPath when provided, otherwise a temp file.

Environment variables

| Variable | Purpose | | --- | --- | | MDREPORTS_TEMPLATES_DIR | User templates directory | | ANTHROPIC_API_KEY | Required for create_template_from_image |