背景
作为开发者,我们经常需要输出技术内容,但制作精美的知识卡片往往耗时且成本高。市面上虽有成熟的 Markdown 转卡片工具,但对于个人开发者而言,长期订阅并不划算。因此,尝试利用 AI 编程助手复刻一个轻量级的 MCP(Model Context Protocol)服务,实现本地化的卡片生成能力,是一个更具性价比的方案。
技术选型
为什么选择 MCP?
MCP 是一种开放标准,旨在让大模型安全、高效地调用外部工具与数据。通过定义标准的 Server 接口,我们可以将卡片生成功能封装为工具,供 Cursor、Trae 等主流 IDE 直接调用。这种方式不仅标准化了集成流程,还能集中管控安全性,让 AI 真正具备执行具体任务的能力。
开发环境
本项目基于 Node.js 生态,利用 npm 进行包管理。配合支持 MCP 协议的 AI 编程助手,可以实现从需求描述到代码生成的闭环。
开发过程
需求定义与提示词
创建一个空文件夹,编写清晰的提示词是第一步。我们需要明确功能边界:将 Markdown 文档转换为精美卡片,支持多种风格(如苹果备忘录、赛博朋克等),并处理长文拆分。
开发一个小红书卡片 MCP 功能:
1. 将 Markdown 文档转换为精美的知识卡片,支持多种风格
2. 支持多种主题样式:苹果备忘录、波普艺术、玻璃拟态等
3. 如果长文就自动拆分
4. 支持直接读取 Markdown 文件
5. 注意符合 MCP 开发规范及中文编码问题
迭代与调试
AI 并非一次性完美交付。在实际运行中,可能会遇到逻辑漏洞或依赖缺失。例如,初次生成的代码可能只返回 HTML 结构而未生成图片文件。此时需要观察日志,指出具体问题,要求 AI 补充图像处理逻辑。
在调试过程中,发现响应格式不符合预期时,可以截取具体的交互记录发送给助手,让它修正解析逻辑。经过几轮修正,AI 能够正确处理输入参数,并输出包含 CSS 样式和元数据的完整响应。
部署与验证
测试通过后,将项目上传至 GitHub 并发布到 NPM。配置好 MCP Host(如 Trae)后,即可在 IDE 中直接调用该工具。

功能特性
最终版本支持以下核心功能:
- Markdown 转卡片:自动渲染文本内容为可视化卡片。
- 多主题支持:内置十余种预设风格,满足不同场景需求。
- 尺寸自适应:根据内容长度自动调整布局。

总结
利用 AI 编程助手开发 MCP 工具,显著降低了工程化落地的门槛。无需深入底层细节,只需关注业务逻辑与接口定义,即可完成从设计到发布的端到端交付。这种模式不仅提升了开发效率,也为后续扩展更多 AI 原生工具提供了参考路径。


