# DingCard

The DingCard MCP server for Claude Code creates cards, posters and slide decks from templates. It checks layouts, exports files and opens designs in an editor.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 16 repo stars
- Author: lottshin
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lottshin/DingCard/tree/HEAD/mcp
- Updated: 2026-10-31
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/dingcard

## What it does

DingCard builds editable cards, posters and slide decks from templates, supplied content or an outline. Its tools can inspect and modify a document, show available assets, and open the result in a browser editor.

Layout checks flag issues such as overlapping text and low contrast. Documents can be exported as PNG, JPG, PDF or a long image. The server keeps its documents between tool calls, and images can be supplied by local file path. Node.js 22 or newer and an installed Chrome browser are required. Web fonts come from Google Fonts; set `DINGCARD_FONTS_URL` to use another font source if needed.

Sharing documents requires a DingCard server address and a token with `images` and `shares` permissions, or DingCard account credentials. The Claude Code setup command is included below.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `DINGCARD_FONTS_URL`, `DINGCARD_CHROME_PATH`, `DINGCARD_SERVER_URL`, `DINGCARD_SERVER_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env DINGCARD_FONTS_URL=<DINGCARD_FONTS_URL> --env DINGCARD_CHROME_PATH=<DINGCARD_CHROME_PATH> --env DINGCARD_SERVER_URL=<DINGCARD_SERVER_URL> --env DINGCARD_SERVER_TOKEN=<DINGCARD_SERVER_TOKEN> --transport stdio mcp -- npx -y dingcard-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env DINGCARD_FONTS_URL=<DINGCARD_FONTS_URL> --env DINGCARD_CHROME_PATH=<DINGCARD_CHROME_PATH> --env DINGCARD_SERVER_URL=<DINGCARD_SERVER_URL> --env DINGCARD_SERVER_TOKEN=<DINGCARD_SERVER_TOKEN> -- npx -y dingcard-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "dingcard-mcp"
            ],
            "env": {
                "DINGCARD_FONTS_URL": "<DINGCARD_FONTS_URL>",
                "DINGCARD_CHROME_PATH": "<DINGCARD_CHROME_PATH>",
                "DINGCARD_SERVER_URL": "<DINGCARD_SERVER_URL>",
                "DINGCARD_SERVER_TOKEN": "<DINGCARD_SERVER_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "dingcard-mcp"
            ],
            "env": {
                "DINGCARD_FONTS_URL": "<DINGCARD_FONTS_URL>",
                "DINGCARD_CHROME_PATH": "<DINGCARD_CHROME_PATH>",
                "DINGCARD_SERVER_URL": "<DINGCARD_SERVER_URL>",
                "DINGCARD_SERVER_TOKEN": "<DINGCARD_SERVER_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e DINGCARD_FONTS_URL=<DINGCARD_FONTS_URL> -e DINGCARD_CHROME_PATH=<DINGCARD_CHROME_PATH> -e DINGCARD_SERVER_URL=<DINGCARD_SERVER_URL> -e DINGCARD_SERVER_TOKEN=<DINGCARD_SERVER_TOKEN> mcp npx -y dingcard-mcp
```
Replace <…> with your own values

## When to use it
- create a poster or slide deck from a template
- find overlapping text and low contrast in a layout
- export a document as PNG, JPG or PDF
- open a design in the browser editor

## Example prompts
- Make a poster from a template and check its text layout.
- Turn this outline into slides and export them as a PDF.
- Open the finished card in the DingCard editor.

## Similar
- [pptx](https://affpapa.org/en/nevibecode/skills/pptx.md) — skill · 241433 installs
- [pdf](https://affpapa.org/en/nevibecode/skills/pdf.md) — skill · 216041 installs
- [gws-shared](https://affpapa.org/en/nevibecode/skills/gws-shared.md) — skill · 69100 installs
- [gws-sheets](https://affpapa.org/en/nevibecode/skills/gws-sheets.md) — skill · 61900 installs
- [slides](https://affpapa.org/en/nevibecode/skills/slides.md) — skill · 49800 installs
- [ppt-master](https://affpapa.org/en/nevibecode/skills/ppt-master.md) — skill · 23300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
