mcpField
M
Md2card Mcp Server

Md2card Mcp Server

本地服务
github.com/maqi1520媒体与设计8064 周前更新

关于 Md2card Mcp Server

MD2Card MCP 服务是将 Markdown 文档转换为知识卡片的 MCP 服务器,通过 npx 或全局安装运行,需配置 MD2CARD_API_KEY 环境变量。适合需要把文章或笔记制作成社交媒体图片的用户。

主要功能

  1. 01支持 22 种主题样式
  2. 02提供多种卡片尺寸类型
  3. 03可读取 Markdown 文件或直接传入内容
  4. 04可抓取微信公众号文章并转为 Markdown

适用场景

  1. 01将 Markdown 笔记转为小红书风格卡片
  2. 02把微信公众号文章整理为可分享的图片
  3. 03按 A4 或海报尺寸生成打印内容

MCP 相关

该项目是一个 MCP 服务器,向 MCP 客户端暴露卡片生成与微信公众号文章抓取工具,客户端通过配置文件启动它。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"md2card-mcp-server-maqi1520": {
"command": "npx",
"args": [
"-y",
"md2card-mcp-server"
],
"env": {
"MD2CARD_API_KEY": "<MD2CARD_API_KEY>"
}
}
}
}
启动命令npx -y md2card-mcp-server
需要配置的环境变量
MD2CARD_API_KEY密钥

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmmd2card-mcp-server

工具

1

收录的工具列表 · 更新于 3 周前

参数类型必填说明
markdownstring否Markdown内容
markdownFilestring否Markdown文件路径
typestring否卡片类型(小红书/正方形/手机海报/A4纸打印)
widthnumber否卡片宽度
heightnumber否卡片高度
themeenum否卡片主题(默认:苹果备忘录)(苹果备忘录/线圈笔记本/波普艺术/字节范/阿里橙/艺术装饰/玻璃拟态/温暖柔和/简约高级灰/梦幻渐变/清新自然/紫色小红书/笔记本/暗黑科技/复古打字机/水彩艺术/中国传统/儿童童话/商务简报/日本杂志/极简黑白/赛博朋克/青野晨光)apple-notes | coil-notebook | pop-art | bytedance | alibaba | art-deco | glassmorphism | warm | minimal | dreamy | nature | xiaohongshu | notebook | darktech | typewriter | watercolor | traditional-chinese | fairytale | business | japanese-magazine | minimalist | cyberpunk | meadow-dawn
themeModeenum否卡片主题模式(默认模式/粉蓝模式/薄荷模式/紫色模式/蓝色模式/粉色模式/黄色模式/亮色模式/暗黑模式)default-mode | pink-blue-mode | mint-mode | purple-mode | blue-mode | pink-mode | yellow-mode | light-mode | dark-mode
splitModestring否卡片拆分模式
mdxModeboolean否是否启用MDX模式
overHiddenModeboolean否是否启用超出高度隐藏

详细介绍

来自项目 README

MD2Card MCP 服务器

homepage: https://md2card.cn

MD2Card Markdown 转知识卡片 将 Markdown 文档转换为精美的知识卡片,支持多种风格

安装与使用

方法一:使用 npx(推荐)

直接使用 npx 运行(需要设置 API 密钥环境变量):

# 设置API密钥并运行
MD2CARD_API_KEY="您的API密钥" npx md2card-mcp-server
方法二:全局安装
# 安装
npm install -g md2card-mcp-server

# 运行(需要设置API密钥环境变量)
MD2CARD_API_KEY="您的API密钥" md2card-mcp-server
方法三:本地配置

clone 项目到本地,找到 index.js 路径替换到客户端 mcp 配置文件中

功能特性

  • 支持 22 种主题样式:苹果备忘录 波普艺术 艺术装饰 玻璃拟态 温暖柔和 简约高级灰 梦幻渐变 清新自然 紫色小红书 笔记本 暗黑科技 复古打字机 水彩艺术 中国传统 儿童童话 商务简报 日本杂志 极简黑白 赛博朋克
  • 智能尺寸适配
  • 三种内容拆分模式:默认自动拆分
  • 通过 MCP 协议提供标准化接口
  • 新功能:支持直接读取 Markdown 文件
  • 新功能:支持通过 type 参数直接指定卡片类型/尺寸
  • 新功能:支持抓取微信公众号文章并转换为 Markdown 格式
  • 新功能:自动提取文章标题、作者、描述和封面图片

使用方法

方法一:提供 Markdown 内容
{
  "markdown": "# 标题\n\n内容"
}
方法二:提供 Markdown 文件路径
{
  "markdownFile": "/path/to/your/file.md"
}
方法三:指定卡片类型/尺寸

可以通过type参数直接指定卡片类型,支持以下类型:

  • 小红书:440x586
  • 正方形:500x500
  • 手机海报:440x782
  • A4 纸打印:595x842
{
  "markdown": "# 标题\n\n内容",
  "type": "小红书"
}

也可以通过 width 和 height 参数指定:

{
  "markdown": "# 标题\n\n内容",
  "width": "小红书",
  "height": 586
}
方法四:抓取微信公众号文章

使用 wechat_scraper 工具抓取微信公众号文章:

{
  "url": "https://mp.weixin.qq.com/s/your-article-id"
}

返回结果包含完整的 Markdown 格式文章,包括:

  • 文章标题
  • 作者信息
  • 文章描述
  • 封面图片
  • 正文内容

客户端配置

通用 MCP 客户端配置

在 MCP 客户端配置文件中添加以下内容:

{
  "md2card-server": {
    "command": "npx",
    "args": ["md2card-mcp-server@latest"],
    "env": {
      "MD2CARD_API_KEY": "您的API密钥"
    }
  }
}
Cursor 客户端配置

在 Cursor 的 MCP 客户端配置文件中添加以下内容:

{
  "md2card-server": {
    "command": "npx",
    "args": ["-y", "md2card-mcp-server@latest"],
    "env": {
      "MD2CARD_API_KEY": "您的API密钥"
    }
  }
}

注意:MD2CARD_API_KEY 环境变量是必需的,只有在实际运行时才会检查此环境变量。安装包时不需要此环境变量。

密钥申请地址:https://md2card.cn/zh?referralCode=github

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。