home / mcp / mdtcard mcp server

MDTCard MCP Server

MCP tool for converting Markdown to beautiful image cards

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "jasperjeje-mdtcard": {
      "command": "npm",
      "args": [
        "run",
        "dev",
        "--mcp"
      ]
    }
  }
}

You can turn Markdown into visually rich knowledge cards with this MCP server. It supports multiple card styles, provides both an MCP and API mode, and includes a set of practical tools to preview, generate, and manage card images for sharing or embedding across platforms.

How to use

You run the MCP server local to your environment and connect your client (such as Claude Desktop, Cursor, or other MCP-enabled tools) to request previews or generated cards. Use the MCP mode for real-time card creation from Markdown, or switch to API mode if you prefer HTTP endpoints for integration. You can preview a card before generating and save the final image for later use.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

Step 1: Install dependencies

npm install

Step 2: Build the project

npm run build

Step 3: Run the MCP server (MCP mode) or the API server (API mode)

npm run dev -- --mcp

npm run dev -- --api

Configuration and runtime options

Choose your running mode based on how you want to integrate card generation.

// Start in MCP server mode to expose card generation tools to MCP clients
npm run dev -- --mcp

// Start in API server mode to expose REST endpoints
npm run dev -- --api

Available tools

list_styles

Lists all available card styles that you can apply when generating a card.

get_style

Returns detailed configuration for a specific card style by its styleId.

preview_card

Generates a card preview from the provided Markdown and style, returning image data suitable for quick visual checks.

generate_card

Creates and saves a card image from Markdown using a chosen style and optional dimensions, returning information about the saved file.

list_generated_images

Lists all generated card images stored by the server.

delete_image

Deletes a previously generated card image by filename.