How do I install Md2Card MCP Server?

Follow the setup instructions on the Md2Card GitHub repository, then add the server configuration to your AI client.

What category is Md2Card MCP Server?

Md2Card is categorized under Developer Tools. Browse more servers in these categories on MCPgee.

Md2Card

Name: Md2Card MCP Server
Author: maqi1520

v1.0.0•Developer Tools•stable

md2card-mcp-server

md2cardmcpai-integration

Stars

Downloads

Weekly

0/5

View on GitHub

What is Md2Card?

Md2Card is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to md2card-mcp-server

md2card-mcp-server

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

md2card-mcp-server

Use Cases

Convert markdown content to card-based formats.

maqi1520

Maintainer

LicenseMIT

Languagetypescript

Versionv1.0.0

UpdatedMay 13, 2026

Statushealthy

Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

View Source Browse All Servers

Installation

Manual Installation

npx md2card

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms

ThroughputMedium

Resource Usage

Memory UsageLow

CPU UsageLow

How to Set Up and Use Md2Card

MD2Card MCP Server connects AI assistants to the md2card.cn service, which converts Markdown text into visually styled knowledge cards suitable for social media platforms like Xiaohongshu. The server exposes tools for generating cards from Markdown content with support for 22 different theme styles, specific card size types, and even scraping WeChat Official Account articles as source material. Developers and content creators use it to instantly turn notes or documentation into shareable visual cards without leaving their AI assistant.

Prerequisites

Node.js 16 or higher with npm installed
An MD2Card API key obtained from md2card.cn (register at https://md2card.cn/zh?referralCode=github)
An MCP-compatible client such as Claude Desktop, Cursor, or Claude Code

Obtain an MD2Card API key

Register at md2card.cn and generate an API key from your account settings. The API key is required to authenticate all card generation requests made through the MCP server.

Test the server manually with npx

Before configuring your MCP client, verify the server starts correctly by running it directly with your API key set as an environment variable.

MD2CARD_API_KEY="your-api-key" npx md2card-mcp-server

Add the server to your MCP client configuration

Open your Claude Desktop or MCP client configuration file and add the md2card server entry. On macOS the config is at ~/Library/Application Support/Claude/claude_desktop_config.json.

Configure environment variable for the API key

Set the MD2CARD_API_KEY in the env block of your MCP configuration so the server always has access to your credentials.

Restart your MCP client and verify

Restart Claude Desktop or your MCP client after saving the config. Open a new conversation and ask it to generate a card from some Markdown text to verify the tool is working.

Md2Card Examples

Client configuration

Add this block to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json). Replace 'your-api-key' with your actual MD2Card API key.

{
  "mcpServers": {
    "md2card-server": {
      "command": "npx",
      "args": ["md2card-mcp-server@latest"],
      "env": {
        "MD2CARD_API_KEY": "your-api-key"
      }
    }
  }
}

Prompts to try

Once connected, ask your AI assistant to convert Markdown content into cards using the md2card tools.

- "Convert this markdown into a knowledge card: ## Tips for Writing\n- Keep it short\n- Use bullet points"
- "Generate a Xiaohongshu card from my notes with the default theme"
- "Create a card using the dark theme style for this markdown content"
- "Scrape this WeChat article and convert it to a card: [article URL]"

Troubleshooting Md2Card

Server starts but card generation fails with authentication error

Verify your MD2CARD_API_KEY is set correctly in the env block of your MCP config. Check that the key is active by testing it at md2card.cn. Keys obtained from the referral link at https://md2card.cn/zh?referralCode=github include free credits.

npx command not found or takes too long on first run

npx downloads the package on first use which can take 10-30 seconds. For faster subsequent starts, install globally: 'npm install -g md2card-mcp-server' and change the config command to 'md2card-mcp-server' with an empty args array.

WeChat article scraping returns empty content

WeChat articles must be publicly accessible. Private or member-only articles cannot be scraped. Try opening the article URL in a browser first to confirm it loads without login.

Frequently Asked Questions about Md2Card

What is Md2Card?

Md2Card is a Model Context Protocol (MCP) server that md2card-mcp-server It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Md2Card?

Follow the installation instructions on the Md2Card GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Md2Card?

Md2Card works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Md2Card free to use?

Yes, Md2Card is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Md2Card Alternatives — Similar Developer Tools Servers

Looking for alternatives to Md2Card? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer Tools Browse All Servers

Set Up Md2Card in Your Editor

Choose your AI client for step-by-step setup instructions.

🖥️

Claude Desktop

macOS & Windows app

⌨️

Claude Code

CLI & terminal

📝

Cursor

AI-first code editor

💻

VS Code

GitHub Copilot MCP

🏄

Windsurf

Codeium AI editor

🔌

Cline

VS Code extension

Quick Config Preview

{
  "mcpServers": {
    "md2card": {
      "command": "npx",
      "args": ["-y", "md2card"]
    }
  }
}

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Md2Card?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides

Explore All Servers Read Our Guides