Mulmocast Vision

🚀 mulmocast-vision

mulmocast-vision 是一款借助 MCP（模型上下文协议）调用大语言模型（LLMs）来自动生成类似 PowerPoint 演示文稿的工具。它拥有 80 多种面向商业的幻灯片模板，能让你快速创建提案、战略报告等专业资料。

🚀 快速开始

mulmocast-vision 无需安装，可直接通过 npx 运行。只需将简单的配置添加到 MCP 客户端（如 Claude Desktop），就能快速开始使用。以下是使用步骤示例：

1. 启动支持 MCP 的客户端（例如 Claude Desktop）。
2. 给出指令，如 “对比 OpenAI、Anthropic、Replicate 等人工智能公司的企业分析，约 20 张幻灯片”。
3. 生成的幻灯片将自动保存在 ~/Documents/mulmocast-vision/{date} 目录下。

✨ 主要特性

• 📑 80 多种丰富模板：针对提案、报告和分析文档进行了商业优化设计。
• ⚡ 即时生成：通过 :contentReference[oaicite:1]{index=1}（MCP）利用大语言模型（LLMs）在数秒内创建专业幻灯片。
• ⚙️ 简单设置：只需在 MCP 客户端添加一个小配置（例如 :contentReference[oaicite:2]{index=2}）即可开始使用。
• 💾 自动保存与轻松导出：输出结果会自动保存在 ~/Documents/mulmocast-vision/ 目录下，还能即时导出为 PDF。
• 🎨 完全可定制：基于 HTML 的模板允许进行细粒度的设计调整或完全重新设计。

你可以点击下面的链接查看示例： 人工智能公司分析幻灯片示例（PDF）

📦 安装指南

无需安装，可直接使用 npx 运行，无需进行全局安装。

💻 使用示例

基础配置

以下是针对 Claude Desktop 的配置示例，你可以将以下内容添加到 claude_desktop_config.json 文件中。其他 MCP 也可使用类似设置：

// claude_desktop_config.json
"mulmocast-vision": {
  "command": "npx",
  "args": [
    "mulmocast-vision@latest"
  ],
  "transport": {
    "stdio": true
  }
}

配置说明：

• 如果 npx 的路径未设置，请指定完整路径。
• 如果尚未安装 npx，请提前进行安装。

实际使用

在支持 MCP 的客户端中，按照以下步骤操作：

1. 启动 MCP 兼容客户端（例如 Claude Desktop）。
2. 给出指令，例如 “对比 OpenAI、Anthropic、Replicate 等人工智能公司的企业分析，约 20 张幻灯片”。
3. 生成的幻灯片将自动保存在 ~/Documents/mulmocast-vision/{date} 目录下。

目前可用的功能包括为每页创建幻灯片、更新指定幻灯片、生成所有幻灯片的 PDF 以及生成指定幻灯片的 PDF。你可以通过提示信息来指示这些操作。

📚 详细文档

输出示例

• 提案（问题 → 解决方案 → 价值 → 下一步行动）
• 商业模式画布
• SWOT 分析、PEST 分析和 3C 分析
• 总结、议程和结束语幻灯片

日志记录

mulmocast-vision 会自动记录所有操作和错误，以帮助进行调试和监控。

日志位置

日志以每日轮换的方式保存在 /tmp/mulmocast-vision-mcp/ 目录下：

• 格式：mcp_yyyymmdd.log（例如 mcp_20251206.log）
• 每天会创建一个新的日志文件

记录内容

• MCP 服务器操作：服务器初始化、工具调用和结果。
• 文件操作：模板读取、HTML/PNG 生成、PDF 创建。
• 错误信息：包含完整堆栈跟踪的详细错误消息。
• 调试信息：模板渲染、目录操作等。

日志格式

日志以 JSON 行格式编写，便于解析：

{
  "timestamp": "2025-01-15T10:30:45.123Z",
  "level": "ERROR",
  "message": "Template file not found",
  "data": {
    "errorMessage": "getHtml: file /path/to/template.html not exists.",
    "errorName": "Error",
    "stack": "Error: getHtml: file...\n    at htmlPlugin.getHtml...",
    "templateFilePath": "/path/to/template.html",
    "functionName": "createAgendaSlide"
  }
}

自定义日志器

你可以用自己的实现替换默认的日志器（例如用于遥测）：

import { setLogger, LoggerInterface } from 'mulmocast-vision/logger';

class CustomLogger implements LoggerInterface {
  info(message: string, data?: unknown) {
    // 你的实现
  }
  // ... 其他方法
}

setLogger(new CustomLogger());

开发者相关

MulmoCast Vision 是开源的，你可以通过修改 HTML 应用各种设计。如需添加样式，请参考 Style.ja.md。

官方仓库与包

• GitHub: receptron/mulmocast-vision
• npm: mulmocast-vision