# io.github.PavelGuzenfeld/media-forge (npm · mcp-media-forge)

MCP server for generating diagrams, charts, presentations, and animations for Markdown documentation

- Trust score: 78/100 (medium)
- Change this week: +34
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `mcp-media-forge`: 78/100 (this document), [markdown](https://verifymcp.io/servers/pavelguzenfeld-media-forge/mcp-media-forge.md), [page](https://verifymcp.io/servers/pavelguzenfeld-media-forge/mcp-media-forge)

## Channel facts

- Registry: `npm`
- Package: `mcp-media-forge`
- Version: `0.2.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to PavelGuzenfeld/mcp-media-forge).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 144 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 67/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1433 tokens (~179/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add pavelguzenfeld-media-forge -- npx -y mcp-media-forge
```

### Codex

```bash
codex mcp add pavelguzenfeld-media-forge -- npx -y mcp-media-forge
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pavelguzenfeld-media-forge": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-media-forge"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add pavelguzenfeld-media-forge --command npx --arg -y --arg mcp-media-forge
```

### Hermes

```yaml
mcp_servers:
  pavelguzenfeld-media-forge:
    command: "npx"
    args: ["-y", "mcp-media-forge"]
```

### Other

```json
{
  "mcpServers": {
    "pavelguzenfeld-media-forge": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-media-forge"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 78, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 77, +58)

- [security improvement] Install scripts: unverified → pass
- [security improvement] Provenance: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] The attested source repository moved: PavelGuzenfeld/mcp-media-forge
- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Stability: unverified → 0.23
- [functional improvement] Dependency health: unverified → partial
- [functional] First check of Schema quality: unverified
- [functional] Licence: MIT

### 2026-08-01 (score 19, −5)

- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Capabilities: pass → unverified

### 2026-07-31 (score 24, −20)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 44)

First indexed and scored.

## MCP tools (8)

### `get_tool_guide` (~113 tokens)

Get usage guide for a rendering tool — includes examples, anti-patterns to avoid, complexity limits, and tips. Call this BEFORE your first render to avoid common mistakes. Available guides: mermaid, d2, graphviz, vegalite, html_page, slides (or "all" for a summary).

Input parameters:

- `tool_name` (string, required): Tool to get guide for: "mermaid", "d2", "graphviz", "vegalite", "html_page", "slides", or "all"

### `render_mermaid` (~203 tokens)

Render a Mermaid diagram to SVG or PNG. Supports: flowchart, sequenceDiagram, erDiagram, stateDiagram-v2, gantt, pie, gitGraph, classDiagram, journey, mindmap. IMPORTANT: Code must start with diagram type (e.g., 'flowchart TD'). Do NOT use semicolons. Do NOT use HTML tags in labels. Anti-patterns: 'graph' (use 'flowchart'), unquoted special chars in labels, >25 nodes without subgraphs. Call get_tool_guide('mermaid') for examples and full anti-pattern list.

Input parameters:

- `code` (string, required): Mermaid diagram code. Must start with diagram type declaration (e.g., 'flowchart TD', 'sequenceDiagram'). No semicolons.
- `format` (string): Output format. SVG preferred (smaller, git-friendly diffs)
- `theme` (string): Mermaid theme. 'neutral' best for docs, 'forest' for dark backgrounds

### `render_d2` (~210 tokens)

Render a D2 architecture diagram to SVG or PNG. Best for: architecture diagrams with containers, nested groups, icons, and complex layouts. IMPORTANT: D2 syntax is NOT Mermaid. Use '->' for arrows (not '-->'), containers with 'name: { ... }' (not 'subgraph'). Anti-patterns: Mermaid syntax, unbalanced braces, >3 nesting levels. Call get_tool_guide('d2') for examples.

Input parameters:

- `code` (string, required): D2 diagram code. Use '->' for arrows, 'name: { ... }' for containers. NOT Mermaid syntax.
- `format` (string): Output format. SVG preferred. PNG is slower (requires Chromium conversion).
- `layout` (string): Layout engine. dagre=hierarchical (default), elk=complex layouts with many crossings
- `theme` (number): D2 theme ID: 0=default, 1=neutral-grey, 3=terminal, 100=neutral-default

### `render_graphviz` (~219 tokens)

Render a Graphviz DOT diagram to SVG or PNG. Best for: dependency graphs, network diagrams, tree structures, large auto-layout graphs (100+ nodes). IMPORTANT: Source must be wrapped in 'digraph G { ... }' or 'graph G { ... }'. Use '->' with digraph, '--' with graph. Engine guide: dot=hierarchical, neato=spring, fdp=force-directed, sfdp=large graphs, circo=circular, twopi=radial. Call get_tool_guide('graphviz') for examples.

Input parameters:

- `dot_source` (string, required): Graphviz DOT source. Must start with 'digraph G {' or 'graph G {'. Use '->' for directed, '--' for undirected.
- `engine` (string): Layout engine: dot=hierarchical, neato=spring, fdp=force-directed, sfdp=large, circo=circular, twopi=radial
- `format` (string): Output format. SVG preferred.

### `render_chart` (~184 tokens)

Render a Vega-Lite chart to SVG or PNG. Supports: bar, line, point (scatter), area, rect (heatmap), boxplot, and layered/composite charts. IMPORTANT: spec_json must be valid JSON with "$schema", "data", "mark", and "encoding" fields. Anti-patterns: missing $schema, omitting encoding types, >500 inline data rows. Call get_tool_guide('vegalite') for examples.

Input parameters:

- `format` (string): Output format. SVG preferred.
- `scale` (number): Scale factor for PNG (default: 1). Use 2 for retina-crisp output.
- `spec_json` (string, required): Vega-Lite JSON spec (as string). Must include "$schema", "data", "mark", "encoding". Always specify encoding types (quantitative/nominal/temporal/ordinal).

### `render_html_page` (~268 tokens)

Render a self-contained themed HTML page from body content. No Docker required. Wraps your HTML in a design system with typography, depth tiers, cards, grids, KPIs, badges, and section navigation. IMPORTANT: body_html is the INNER content only — do NOT include <html>, <head>, or <body> tags. Use mf- prefixed CSS classes: mf-hero, mf-elevated, mf-card, mf-grid, mf-kpi, mf-badge-success, etc. Themes: swiss (clean docs), midnight (presentations), warm (reports), terminal (dev content). Call get_tool_guide('html_page') for design system reference and examples.

Input parameters:

- `body_html` (string, required): HTML body content (inner content only, no <html>/<head>/<body>). Use mf- prefixed classes for styling.
- `description` (string): Page description (shown below title and in meta tag)
- `nav_sections` (array): Section names for floating navigation. Must match id attributes on <section> elements in body_html.
- `theme` (string): Visual theme: swiss=clean docs, midnight=dark editorial, warm=cream reports, terminal=dev monospace
- `title` (string, required): Page title (shown in header and browser tab)

### `render_slides` (~202 tokens)

Render a self-contained HTML slide deck with keyboard/touch navigation, progress bar, and transitions. No Docker required. Supports 8 slide types: title, content, split, code, quote, kpi, image, section. IMPORTANT: slides is a JSON array string of objects with title, content (HTML), and optional type. Content density limits: max 6 bullets per slide, max 10 code lines, max 25 words for quotes, max 30 slides total. Call get_tool_guide('slides') for slide type reference and examples.

Input parameters:

- `author` (string): Author name (shown on title slide)
- `slides` (string, required): JSON array of slide objects: [{"title": "...", "content": "HTML...", "type": "content|title|split|code|quote|kpi|image|section"}]
- `theme` (string): Visual theme for the slide deck
- `title` (string, required): Presentation title

### `list_assets` (~34 tokens)

List all generated media assets in the output directory.

Input parameters:

- `directory` (string): Subdirectory to list (default: docs/generated)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/pavelguzenfeld-media-forge/mcp-media-forge#diagnostics

## Score history

- 2026-08-03: 78
- 2026-08-02: 77
- 2026-08-01: 19
- 2026-07-31: 24
- 2026-07-30: 44
- 2026-07-28: 44
- 2026-07-27: 44

## Links

- npm package: https://www.npmjs.com/package/mcp-media-forge
- Socket report: https://socket.dev/npm/package/mcp-media-forge
- Repository: https://github.com/PavelGuzenfeld/mcp-media-forge
- Changelog RSS feed: https://verifymcp.io/servers/pavelguzenfeld-media-forge/mcp-media-forge/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/pavelguzenfeld-media-forge/mcp-media-forge/changelog.json
- HTML version of this page: https://verifymcp.io/servers/pavelguzenfeld-media-forge/mcp-media-forge