Content
# MD2Card MCP Server
homepage: https://md2card.cn
MD2Card
Markdown 转知识卡片
Convert Markdown documents into beautiful knowledge cards, supporting various styles
## Installation and Usage
### Method 1: Use npx (Recommended)
Run directly using npx (requires setting the API key environment variable):
```bash
# Set the API key and run
MD2CARD_API_KEY="your API key" npx md2card-mcp-server
```
### Method 2: Global Installation
```bash
# Install
npm install -g md2card-mcp-server
# Run (requires setting the API key environment variable)
MD2CARD_API_KEY="your API key" md2card-mcp-server
```
### Method 3: Local Configuration
Clone the project locally and find the index.js path to replace it in the client mcp configuration file.
## Features
- Supports 22 theme styles: Apple Notes, Pop Art, Art Deco, Glassmorphism, Warm and Soft, Minimalist Gray, Dreamy Gradient, Fresh and Natural, Purple Xiaohongshu, Notebook, Dark Technology, Retro Typewriter, Watercolor Art, Chinese Traditional, Children's Fairy Tale, Business Briefing, Japanese Magazine, Minimalist Black and White, Cyberpunk
- Intelligent size adaptation
- Three content splitting modes: Default automatic splitting
- Provides a standardized interface through the MCP protocol
- **New Feature**: Supports directly reading Markdown files
- **New Feature**: Supports specifying card type/size directly via the type parameter
- **New Feature**: Supports scraping WeChat official account articles and converting them to Markdown format
- **New Feature**: Automatically extracts article title, author, description, and cover image
## Usage
### Method 1: Provide Markdown Content
```json
{
"markdown": "# Title\n\nContent"
}
```
### Method 2: Provide Markdown File Path
```json
{
"markdownFile": "/path/to/your/file.md"
}
```
### Method 3: Specify Card Type/Size
You can directly specify the card type using the `type` parameter, supporting the following types:
- Xiaohongshu: 440x586
- Square: 500x500
- Mobile Poster: 440x782
- A4 Paper Print: 595x842
```json
{
"markdown": "# Title\n\nContent",
"type": "Xiaohongshu"
}
```
You can also specify using the width and height parameters:
```json
{
"markdown": "# Title\n\nContent",
"width": "Xiaohongshu",
"height": 586
}
```
### Method 4: Scrape WeChat Official Account Articles
Use the `wechat_scraper` tool to scrape WeChat official account articles:
```json
{
"url": "https://mp.weixin.qq.com/s/your-article-id"
}
```
The return result includes the complete Markdown format article, including:
- Article title
- Author information
- Article description
- Cover image
- Article content
## Client Configuration
### General MCP Client Configuration
Add the following to the MCP client configuration file:
```json
{
"md2card-server": {
"command": "npx",
"args": ["md2card-mcp-server@latest"],
"env": {
"MD2CARD_API_KEY": "your API key"
}
}
}
```
### Cursor Client Configuration
Add the following to the Cursor MCP client configuration file:
```json
{
"md2card-server": {
"command": "npx",
"args": ["-y", "md2card-mcp-server@latest"],
"env": {
"MD2CARD_API_KEY": "your API key"
}
}
}
```
> Note: The MD2CARD_API_KEY environment variable is required and will only be checked during actual runtime. This environment variable is not required when installing the package.
Key application address: https://md2card.cn/zh?referralCode=github
Connection Info
You Might Also Like
OpenAI Whisper
OpenAI Whisper MCP Server - 基于本地 Whisper CLI 的离线语音识别与翻译,无需 API Key,支持...
markitdown
Python tool for converting files and office documents to Markdown.
oh-my-opencode
Background agents · Curated agents like oracle, librarians, frontend...
Charles-mcp
Charles Proxy MCP server with live capture and structured traffic analysis
sdl-mcp
A cards-first context system for coding agents that indexes repositories...
claude-historian-mcp
🤖 An MCP server for Claude Code conversation history