md2card

MD2Card MCP 服务器将 Markdown 内容转换为可直接用于知识卡片的格式。通过 MCP 协议暴露的标准接口，客户端可以提交 Markdown 内容、指定卡片尺寸/类型，甚至直接从 Markdown 文件或微信公众号文章生成卡片。该服务支持多种主题样式（22 种）、智能尺寸适配，以及三种内容拆分模式，帮助你将长文整理成更易于浏览的知识卡片。要使用它，请在请求中提供 Markdown 内容（或 Markdown 文件路径）、可选的 type/width/height 参数，以及必要的环境变量（如 MD2CARD_API_KEY）以便授权。若需要从微信文章创建卡片，可以先通过 wechat_scraper 获取 Markdown 版本再提交给服务器。

Prerequisites:

• Node.js 和 npm 已安装（推荐使用 npx 直接运行，无需全局安装）。
• 需要一个 MD2CARD_API_KEY 以授权 API 调用。

安装与运行的常用方法：

方法 1：使用 npx（推荐）

• 直接运行：
  • 在命令行执行： MD2CARD_API_KEY="你的 API 密钥" npx md2card-mcp-server
  • 这会从 npm 注册表获取 md2card-mcp-server 并启动服务器。

方法 2：全局安装（可离线运行）

• 全局安装：
  • npm install -g md2card-mcp-server
• 运行（需要 API 密钥）：
  • MD2CARD_API_KEY="你的 API 密钥" md2card-mcp-server

方法 3：本地配置/克隆源码

• 克隆仓库到本地，进入项目目录，安装依赖并运行。
• 在本地按需修改配置以指向本地入口（如 index.js）。

每种方法运行时，若未提供 MD2CARD_API_KEY，服务将提示错误并拒绝授权访问。

Tips:

• MD2CARD_API_KEY 环境变量是必需的，仅在实际运行时进行检查。若仅用于测试，请确保提供有效的密钥。
• 支持通过 type、width、height 指定卡片类型或自定义尺寸，例如：type 可以为“{小红书|440x586|等}”对应的样式，width/height 亦可覆盖默认尺寸。
• 新增功能包括直接读取 Markdown 文件、从微信公众号文章抓取并转换为 Markdown、以及通过 type 参数直接指定卡片类型/尺寸。
• 客户端配置中示例展示了如何在 MCP 客户端配置文件中设置命令、参数以及环境变量，确保 MD2CARD_API_KEY 能在运行时被环境变量读取。若遇到权限或网络问题，请检查网络连通性和 npm 是否能正确获取包。
• 如需更新版本，使用 md2card-mcp-server@latest 以获取最新功能。