MD2Card MCP server converts Markdown documents into visual image cards. It exposes a standardized MCP interface that accepts Markdown content and returns generated card assets, with support for multiple visual themes and automatic content sizing. The server supports 19 theme styles (e.g., Apple Notes-inspired, Pop Art, Glassmorphism, Warm Soft Tones, Minimal Gray, Dreamy Gradients, Fresh & Natural, Purple Little Red Book, Classic Notebook, Dark Tech, Vintage Typewriter, Watercolor, Chinese Traditional, Children's Fairy Tale,商务简报, Japanese Magazine, Ultra Minimal Black & White, Cyberpunk) and automatically adapts card size based on content. You can configure which theme to use per request by selecting the appropriate style in your client or by extending the MCP payload to include a theme parameter. The MCP client config example shows how to wire the server by setting the node command and the path to the built index, along with an API key for authentication with the MD2Card service. In practice, you would send Markdown content to the MCP endpoint, and receive the resulting card image assets ready for embedding in your workflow or game client.

Prerequisites:

• Node.js (v14+ recommended)
• npm or Yarn

Installation steps:

1. Clone the repository: git clone https://github.com/user-attachments/md2card-mcp-server.git cd md2card-mcp-server

2. Install dependencies: npm install

   or using Yarn: yarn install

3. Build or prepare the index.js entry (if a build step exists). If you already have a built index at path/to/build/index.js, skip to step 4. Otherwise, run your project's build script as defined in package.json.

4. Run the MCP server locally (as per mcp_config): node path/to/build/index.js

5. Optional: set environment variables (e.g., API keys) as needed when starting the server, or configure through your MCP client to inject MD2CARD_API_KEY at runtime.

Notes:

• The exact path to the server entry (path/to/build/index.js) should be replaced with your actual build output location.
• If a start script (npm run start) is provided by the project, you can alternatively run that script after npm install.

Environment variables and configuration:

• MD2CARD_API_KEY: Required for authenticating with the MD2Card API. Set this in your MCP client configuration or as an environment variable when starting the server.

Tips and common issues:

• Ensure Node.js version compatibility with the server code and dependencies.
• If the server does not respond, verify that path/to/build/index.js is correct and that the server process is running.
• When changing themes, confirm that the MCP client payload includes the selected theme parameter if supported by the server.
• If you encounter API quota or authentication errors, check your API key’s validity and access rights in the MD2Card dashboard.

Configuration options:

• You can adjust theme, content segmentation settings, and other rendering options by extending the MCP payload or by exposing additional environment/config flags in the server code.