小红薯📕卡片MCP (Little Red Book Card MCP)
将 Markdown 文档转换为精美的知识卡片，支持多种风格的MCP工具。
如何在MCP中配置小红书卡片工具
基本配置格式
{
"mcpServers": {
"little-red-book-card-mcp": {
"command": "npx",
"args": ["@lucianaib/little-red-book-card-mcp"]
}
}
}
使用效果
随便制作一个Markdown内容，并将其转换为知识卡片图片，儿童童话风格，尺寸为手机大小
效果如下：
功能特性
🎨 多种主题样式
支持18种不同的主题风格，满足各种场景需求：
现代风格
- 📱 苹果备忘录 - 简洁清新的苹果风格备忘录
- 🪟 玻璃拟态 - 现代玻璃拟态效果
- 🌈 梦幻渐变 - 梦幻般的渐变色彩
- 🌿 清新自然 - 清新的自然绿色调
创意风格
- 🎨 波普艺术 - 鲜艳大胆的波普艺术风格
- 🏛️ 艺术装饰 - 奢华的装饰艺术风格
- 🎭 水彩艺术 - 水彩画艺术效果
- 🌌 赛博朋克 - 赛博朋克霓虹风格
专业风格
- 📊 商务简报 - 专业商务简报风格
- 📰 日本杂志 - 日本杂志排版风格
- 🖋️ 复古打字机 - 复古打字机风格
- 📓 笔记本 - 仿笔记本纸张效果
特色风格
- 🟣 紫色小红书 - 小红书风格的紫色主题
- 🇨🇳 中国传统 - 中国传统文化风格
- 🧸 儿童童话 - 儿童童话风格
- ⚫ 极简黑白 - 极简黑白配色
- 🌟 温暖柔和 - 温暖舒适的柔和色调
- 🏢 简约高级灰 - 极简的高级灰色调
- 🖤 暗黑科技 - 暗黑科技风格
📝 核心功能
- ✅ Markdown转HTML卡片 - 将Markdown文档转换为精美的知识卡片
- 🖼️ 图片生成功能 - 将HTML卡片转换为PNG/JPEG图片文件
- 📁 文件读取支持 - 支持直接读取Markdown文件
- 🎯 多种卡片类型 - 支持通过type参数指定卡片类型/尺寸
- 📊 内容统计 - 自动计算字数和字符数
- 🌟 长内容处理 - 智能分割长内容，避免性能问题
- 🔧 MCP集成 - 完整的MCP工具集成，易于集成到各种平台
快速开始
全局安装
npm install -g little-red-book-card-mcp
或者使用pnpm：
pnpm add little-red-book-card-mcp
作为MCP工具使用
-
启动MCP服务器：
node dist/index.js -
可用工具：
convert_markdown_to_card- 将Markdown转换为知识卡片generate_card_image- 将Markdown转换为知识卡片图片list_available_themes- 列出所有可用主题
-
转换示例：
HTML卡片生成（默认手机尺寸 mobile）：
{ "name": "convert_markdown_to_card", "arguments": { "content": "# 标题\n\n这是Markdown内容。", "theme": "紫色小红书", "type": "mobile", "filePath": "optional/path/to/file.md" } }图片生成示例（默认手机尺寸 mobile）：
{ "name": "generate_card_image", "arguments": { "content": "# 标题\n\n这是Markdown内容。", "theme": "清新自然", "type": "mobile", "outputDir": "./output", "format": "png", "quality": 80 } }
API接口
convert_markdown_to_card
将Markdown内容转换为知识卡片。
参数：
content(string, 必需) - Markdown内容theme(string, 必需) - 主题名称type(string, 可选) - 卡片类型 ('mobile', 'standard', 'large', 'small', 'wide')，默认mobilefilePath(string, 可选) - Markdown文件路径
返回：
{
"html": "完整的HTML卡片代码",
"css": "主题CSS样式",
"metadata": {
"theme": "主题名称",
"type": "卡片类型",
"wordCount": "字数",
"charCount": "字符数"
}
}
generate_card_image
将Markdown内容转换为知识卡片图片。
参数：
content(string, 必需) - Markdown内容theme(string, 必需) - 主题名称type(string, 可选) - 卡片类型 ('mobile', 'standard', 'large', 'small', 'wide')，默认mobilefilePath(string, 可选) - Markdown文件路径outputDir(string, 可选) - 输出目录，默认为当前目录format(string, 可选) - 图片格式 ('png', 'jpeg')，默认为 'png'quality(number, 可选) - 图片质量（仅jpeg格式），默认为 80
返回：
{
"imagePath": "生成的图片文件路径",
"metadata": {
"theme": "主题名称",
"type": "卡片类型",
"format": "图片格式",
"size": "文件大小（字节）",
"wordCount": "字数",
"charCount": "字符数"
}
}
list_available_themes
列出所有可用的主题样式。
返回：
{
"themes": [
{
"name": "主题名称",
"key": "主题键名",
"description": "主题描述"
}
],
"count": "主题数量"
}
开发环境设置
克隆和安装
git clone <repository-url>
cd little-red-book-card-mcp
pnpm install
编译和运行
# 编译项目
npm run build
# 运行开发服务器
npm run dev
# 运行测试（Jest）
npm test
# 查看测试覆盖率
npm run test:coverage
文件结构
├── src/
│ ├── index.ts # MCP主服务器实现
├── tests/
│ ├── index.test.ts # 主要测试文件
│ ├── setup.ts # 测试环境设置
├── dist/ # 编译输出目录
├── package.json # 项目配置
├── tsconfig.json # TypeScript配置
├── jest.config.js # Jest测试配置
└── README.md # 项目说明
### 常用脚本
- `npm run build`：编译 TypeScript
- `npm run start`：启动 MCP 服务器（stdio）
- `npm run generate:pop-mobile`：生成波普艺术手机尺寸示例图片
技术栈
- TypeScript - 类型安全的JavaScript开发
- Node.js - 运行时环境
- MCP SDK - Model Context Protocol开发框架
- marked - Markdown解析器
- cheerio - HTML操作库
- puppeteer - HTML到图片转换
- Jest - 测试框架
许可证
MIT License - 详见 LICENSE 文件
贡献
欢迎提交Issue和Pull Request！
开发指南
- Fork 项目
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
代码规范
- 使用 TypeScript 编写
- 遵循 ESLint 规范
- 添加适当的单元测试
- 保持代码注释清晰
更新日志
v1.0.2 (2024-10-29)
- 🚀 成功发布到npm registry
- 🔧 修复包名配置问题
- 📝 更新MCP配置示例
- 🧪 优化发布流程
v1.0.0 (2024-10-29)
- ✅ 初始版本发布
- 🎨 支持18种主题样式
- 📝 实现Markdown到HTML卡片转换
- 📁 支持文件读取功能
- 🔧 完整的MCP工具集成
- 📊 自动内容统计功能
- 🌟 长内容智能分割
- 🧪 完整的测试覆盖
支持
如果您在使用过程中遇到问题，可以通过以下方式获得帮助：
- 📖 查看 文档
- 🐛 提交 Issue
- 📧 发送邮件至 support@example.com
致谢
感谢所有为这个项目做出贡献的开发者和测试者！
小红书卡片MCP - 让您的Markdown内容焕发新生！