Skip to content
MCP server

DingCard

Make posters, social cards and slide decks from templates, check layout, export images

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Web, self-hosted
Runs
Locally
Version
0.61.1
Listing updated
3 days ago

About DingCard

DingCard is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

DingCard is an open-source editor for cards and posters, and its stdio MCP server lets an assistant drive the same document model. The README lists 22 tools: generate a document from a template, from raw content or from an outline, inspect and edit it with the editor's own reducer, list icons, ornaments, palettes, fonts, filters and puzzle layouts, and read a guide by topic.

What sets it apart is the check step. check_document lays the design out as it will export and lists problems such as overflowing or overlapping text, low contrast, leftover sample copy, tiny text, empty bands and too many fonts; with fix enabled, text that does not fit is shrunk. render_document then writes PNG, JPG, PDF, a long image or a 3x3 grid, and open_in_editor hands the result to a person in the browser editor.

It needs Node.js 22 or newer and a local Chrome for rendering, and fetches web fonts from Google Fonts unless you set another source. Tool descriptions are written in Chinese. The project is MIT-licensed.

Install

Run in a terminal

claude mcp add dingcard --env DINGCARD_SERVER_TOKEN='<DINGCARD_SERVER_TOKEN>' -- npx -y dingcard-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "dingcard": {
      "command": "npx",
      "args": [
        "-y",
        "dingcard-mcp"
      ],
      "env": {
        "DINGCARD_SERVER_TOKEN": "<DINGCARD_SERVER_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "dingcard": {
      "command": "npx",
      "args": [
        "-y",
        "dingcard-mcp"
      ],
      "env": {
        "DINGCARD_SERVER_TOKEN": "<DINGCARD_SERVER_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "dingcard": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "dingcard-mcp"
      ],
      "env": {
        "DINGCARD_SERVER_TOKEN": "<DINGCARD_SERVER_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "dingcard": {
      "command": "npx",
      "args": [
        "-y",
        "dingcard-mcp"
      ],
      "env": {
        "DINGCARD_SERVER_TOKEN": "<DINGCARD_SERVER_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "dingcard": {
      "command": "npx",
      "args": [
        "-y",
        "dingcard-mcp"
      ],
      "env": {
        "DINGCARD_SERVER_TOKEN": "<DINGCARD_SERVER_TOKEN>"
      }
    }
  }
}

Configuration

  • DINGCARD_FONTS_URLWhere to download web fonts instead of https://fonts.googleapis.com, e.g. https://fonts.googleapis.cn
  • DINGCARD_CHROME_PATHPath to Chrome when it is not installed in the usual place (used for checks and renders)
  • DINGCARD_SERVER_URLA deployed DingCard server, for share links and saved projects
  • DINGCARD_SERVER_TOKENAPI token for DINGCARD_SERVER_URL (scopes: images and shares; drafts for projects)

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

create_document_from_template
Creates a document from a template.
create_document_from_content
Creates a full card set from content, replacing sample text.
create_document_from_outline
Creates a document from an outline.
inspect_document
Inspects a document.
apply_actions
Edits a document with the editor's own reducer.
list_assets
Lists icons, ornaments, palettes, fonts, filters and puzzle layouts.
get_guide
Reads the writing guide by topic.
check_document
Lists visible layout problems as the design will export.
render_document
Renders PNG, JPG, PDF or long image output.
render_markdown
Renders Markdown into cards.
open_in_editor
Opens the document in the browser editor.
get_document
Returns the document.
list_templates
Lists templates with size, purpose and style.
share_document
Turns a design into a share link via a deployed server.

What it does

Three ways to generate
Create from a template, from content or from an outline.
Layout checking
Flags overflow, overlap, low contrast, leftover sample text and more.
Auto-fix text
Shrinks text that does not fit when fix is on.
Multiple export formats
Renders PNG, JPG, PDF, long images or a 3x3 grid.
Editor handoff
Opens the result in the browser editor for a person to finish.
Template library
88 templates in the site's template centre.

Good for

  • Turn an article into a set of social media cards
  • Produce a poster from a template and fix text that overflows
  • Generate a slide deck and export it as a PDF
  • Review an AI-made design for contrast and alignment problems

Pricing

Open source

MIT licence; free

Prices change. Check dingcard.pages.dev before you buy.

DingCard FAQ

What does it need locally?

Node.js 22 or newer and Google Chrome, which is used for checks and rendering.

Is it open source?

Yes, under the MIT licence.

What language are the tool descriptions in?

Chinese, according to the README.

Can I share a design by link?

Yes, if you set DINGCARD_SERVER_URL and a token for a deployed DingCard server.

Is DingCard free?

Yes. DingCard is open source, so you can use and self-host it for free.

How do I add DingCard to Claude Code?

Run this command in your terminal: claude mcp add dingcard --env DINGCARD_SERVER_TOKEN='<DINGCARD_SERVER_TOKEN>' -- npx -y dingcard-mcp

What are the best alternatives to DingCard?

The closest alternatives to DingCard are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

Alternatives to DingCard

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media