https://github.com/maqi1520/md2card-mcp-server
md2card-mcp-server
https://github.com/maqi1520/md2card-mcp-server
Last synced: 3 months ago
JSON representation
md2card-mcp-server
- Host: GitHub
- URL: https://github.com/maqi1520/md2card-mcp-server
- Owner: maqi1520
- Created: 2025-06-12T16:00:26.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-08-04T14:44:57.000Z (3 months ago)
- Last Synced: 2025-08-04T17:19:34.464Z (3 months ago)
- Language: TypeScript
- Size: 60.5 KB
- Stars: 38
- Watchers: 0
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **md2card-mcp-server** - md2card-mcp-server (TypeScript-based) `typescript` `mcp` `server` `npm install maqi1520/md2card-mcp-server` (🌐 Web Development)
README
# MD2Card MCP 服务器
homepage: https://md2card.cn
MD2Card
Markdown 转知识卡片
将 Markdown 文档转换为精美的知识卡片，支持多种风格
## 安装与使用
### 方法一：使用 npx（推荐）
直接使用 npx 运行（需要设置 API 密钥环境变量）：
```bash
# 设置API密钥并运行
MD2CARD_API_KEY="您的API密钥" npx md2card-mcp-server
```
### 方法二：全局安装
```bash
# 安装
npm install -g md2card-mcp-server
# 运行（需要设置API密钥环境变量）
MD2CARD_API_KEY="您的API密钥" md2card-mcp-server
```
### 方法三：本地配置
clone 项目到本地，找到 index.js 路径替换到客户端 mcp 配置文件中
## 功能特性
- 支持 22 种主题样式：苹果备忘录 波普艺术 艺术装饰 玻璃拟态 温暖柔和 简约高级灰 梦幻渐变 清新自然 紫色小红书 笔记本 暗黑科技 复古打字机 水彩艺术 中国传统 儿童童话 商务简报 日本杂志 极简黑白 赛博朋克
- 智能尺寸适配
- 三种内容拆分模式：默认自动拆分
- 通过 MCP 协议提供标准化接口
- **新功能**：支持直接读取 Markdown 文件
- **新功能**：支持通过 type 参数直接指定卡片类型/尺寸
- **新功能**：支持抓取微信公众号文章并转换为 Markdown 格式
- **新功能**：自动提取文章标题、作者、描述和封面图片
## 使用方法
### 方法一：提供 Markdown 内容
```json
{
"markdown": "# 标题\n\n内容"
}
```
### 方法二：提供 Markdown 文件路径
```json
{
"markdownFile": "/path/to/your/file.md"
}
```
### 方法三：指定卡片类型/尺寸
可以通过`type`参数直接指定卡片类型，支持以下类型：
- 小红书：440x586
- 正方形：500x500
- 手机海报：440x782
- A4 纸打印：595x842
```json
{
"markdown": "# 标题\n\n内容",
"type": "小红书"
}
```
也可以通过 width 和 height 参数指定：
```json
{
"markdown": "# 标题\n\n内容",
"width": "小红书",
"height": 586
}
```
### 方法四：抓取微信公众号文章
使用 `wechat_scraper` 工具抓取微信公众号文章：
```json
{
"url": "https://mp.weixin.qq.com/s/your-article-id"
}
```
返回结果包含完整的 Markdown 格式文章，包括：
- 文章标题
- 作者信息
- 文章描述
- 封面图片
- 正文内容
## 客户端配置
### 通用 MCP 客户端配置
在 MCP 客户端配置文件中添加以下内容：
```json
{
"md2card-server": {
"command": "npx",
"args": ["md2card-mcp-server@latest"],
"env": {
"MD2CARD_API_KEY": "您的API密钥"
}
}
}
```
### Cursor 客户端配置
在 Cursor 的 MCP 客户端配置文件中添加以下内容：
```json
{
"md2card-server": {
"command": "npx",
"args": ["-y", "md2card-mcp-server@latest"],
"env": {
"MD2CARD_API_KEY": "您的API密钥"
}
}
}
```
> 注意：MD2CARD_API_KEY 环境变量是必需的，只有在实际运行时才会检查此环境变量。安装包时不需要此环境变量。
密钥申请地址：https://md2card.cn/zh?referralCode=github