mulmocast-vision

mulmocast-vision

注意：此仓库已归档。开发工作已迁移至 mulmocast-plus monorepo（packages/mulmocast-vision）。

mulmocast-vision 是一款通过 MCP（Model Context Protocol）使用大模型自动生成类似 PowerPoint 的演示幻灯片的工具。
借助 80 多种面向商务场景的幻灯片模板，你可以快速创建提案、战略演示文稿及其他专业材料。

✨ 功能

• 📑 80 多种丰富模板
  专为提案、报告和分析文档优化的设计

• ⚡ 即时生成
  通过 :contentReference[oaicite:1]{index=1}（MCP）使用大模型，在几秒钟内创建专业幻灯片

• ⚙️ 简单配置
  只需在 MCP 客户端（例如 :contentReference[oaicite:2]{index=2}）中添加少量配置即可开始使用

• 💾 自动保存与轻松导出
  输出内容会自动保存到 ~/Documents/mulmocast-vision/
  可立即导出为 PDF

• 🎨 完全可自定义
  基于 HTML 的模板支持精细调整设计，或完全重新设计

只需几分钟即可创建此类文档。

AI 公司分析幻灯片示例（PDF）

无需安装

可直接通过 npx 运行，无需全局安装。

设置

以下是 Claude 桌面应用的示例。将以下内容添加到你的 claude_desktop_config.json。
其他 MCP 也可以使用类似设置。

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

设置就这么简单。
如果未设置 npx 的路径，请指定完整路径。
如果尚未安装 npx，请提前安装。

用法

1. 启动兼容 MCP 的客户端（例如 Claude Desktop）
2. 只需输入类似“比较 OpenAi、Anthropic、Replicate 等 AI 公司的企业分析。大约 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 Lines 格式写入，便于解析：

{
  "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) {
    // Your implementation
  }
  // ... other methods
}

setLogger(new CustomLogger());

面向开发者

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

官方仓库与软件包

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

---

mulmocast-vision（日本語版）

mulmocast-vision 是一款通过 MCP（Model Context Protocol）使用大模型，自动生成类似 PowerPoint 的幻灯片资料的工具。 它提供 80 种专为商务场景设计的幻灯片模板，可轻松创建企划书、提案资料和战略资料。

---

特徴

• 📑 豊富なテンプレート: ビジネスに最適化された 80種類以上のスライドデザイン
• ⚡ 即時生成: LLM と MCP を通じて、最短数秒でプレゼン資料を出力
• 🖥️ シンプルな利用方法: MCP対応ツール（例: Claude Desktop）に設定するだけ
• 📂 自動保存: 生成された資料は ~/Documents/mulmocast-vision/ 以下に保存

---

インストール不要

追加のインストールは不要です。npx 経由で直接実行できます。

---

設定方法

MCP対応ツール（例: Claude Desktop）の設定ファイルに以下を追記してください。

"mulmocast-vision": {
  "command": "npx",
  "args": [
    "mulmocast-vision"
  ],
  "transport": {
    "stdio": true
  }
}

---

使い方

1. MCP対応クライアント（Claude Desktop など）を起動
2. mulmocast-vision を呼び出してスライド生成を指示
3. 完成した資料が自動的に ~/Documents/mulmocast-vision/ に保存されます

---

出力例

• 企画書（Problem → Solution → Value → Next Action）
• ビジネスモデルキャンバス
• SWOT分析、PEST分析、3C分析
• サマリースライド、アジェンダスライド、クロージングスライド

---

ログ機能

mulmocast-visionは、デバッグや監視を支援するため、すべての操作とエラーを自動的にログに記録します。

ログの保存場所

ログは /tmp/mulmocast-vision-mcp/ に日次ローテーションで保存されます：

• 形式: mcp_yyyymmdd.log (例: mcp_20251206.log)
• 日付が変わると新しいログファイルが作成されます

記録される内容

• MCPサーバー操作: サーバーの初期化、ツール呼び出し、実行結果
• ファイル操作: テンプレート読み込み、HTML/PNG生成、PDF作成
• エラー: 詳細なエラーメッセージとスタックトレース
• デバッグ情報: テンプレートレンダリング、ディレクトリ操作など

ログフォーマット

ログはJSON Lines形式で記録され、解析が容易です：

{
  "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());