{
  "markdown": "[![npm version](https://badge.fury.io/js/mulmocast-vision.svg)](https://badge.fury.io/js/mulmocast-vision)\n# mulmocast-vision\n\n> **Note**: This repository has been archived. Development has moved to [mulmocast-plus](https://github.com/receptron/mulmocast-plus) monorepo (`packages/mulmocast-vision`).\n\n**mulmocast-vision** is a tool that uses LLMs via MCP (Model Context Protocol) to automatically generate presentation slides, similar to PowerPoint.  \nWith **80+ business-oriented slide templates**, you can quickly create proposals, strategy decks, and other professional materials.  \n\n\n## ✨ Features\n\n- 📑 **80+ Rich Templates**  \n  Business-optimized designs for proposals, reports, and analysis documents\n\n- ⚡ **Instant Generation**  \n  Create professional slides in seconds using LLMs via :contentReference[oaicite:1]{index=1} (MCP)\n\n- ⚙️ **Simple Setup**  \n  Just add a small config to your MCP client (e.g. :contentReference[oaicite:2]{index=2}) to start\n\n- 💾 **Auto Save & Easy Export**  \n  Outputs are automatically saved under `~/Documents/mulmocast-vision/`  \n  Export instantly to PDF\n\n- 🎨 **Fully Customizable**  \n  HTML-based templates allow fine-grained design tweaks or full redesigns\n\nYou can create documents like these in just a few minutes.\n\n[Sample AI Company Analysis Slide (PDF)](https://github.com/isamu/slide_example/blob/master/pdf/AI_Companies_Corporate_Analysis_2025.pdf)\n\n\n## No Installation Needed  \n\nRuns directly with `npx`. No global install required.  \n\n\n## Setup\n\nHere is an example for Claude desktop. Add the following to your `claude_desktop_config.json`.  \nYou can use similar settings for other MCPs.\n\n```json\n// claude_desktop_config.json\n\"mulmocast-vision\": {\n  \"command\": \"npx\",\n  \"args\": [\n    \"mulmocast-vision@latest\"\n  ],\n  \"transport\": {\n    \"stdio\": true\n  }\n}\n```\n\nThat's all for the setup.  \nIf the path to `npx` is not set, specify the full path.  \nIf `npx` is not installed, please install it in advance.\n\n\n## Usage  \n\n1. Launch an MCP-compatible client (e.g., Claude Desktop)  \n2. Just give an instruction like \"Compare corporate analysis of AI companies such as OpenAi Anthropic Replicate. About 20 slides.\".  \n3. The generated slides will be saved automatically under `~/Documents/mulmocast-vision/{date}`  \n\nCurrently available features include creating slides for each page, updating specified slides, generating a PDF of all slides, and generating a PDF for specified slides.  \nYou can instruct these actions via prompts.\n\n\n## Output Examples\n\n- Proposal (Problem → Solution → Value → Next Action)\n- Business Model Canvas\n- SWOT, PEST, and 3C Analysis\n- Summary, Agenda, and Closing Slides\n\n## Logging\n\nmulmocast-vision automatically logs all operations and errors to help with debugging and monitoring.\n\n### Log Location\n\nLogs are saved in `/tmp/mulmocast-vision-mcp/` with daily rotation:\n- Format: `mcp_yyyymmdd.log` (e.g., `mcp_20251206.log`)\n- Each day creates a new log file\n\n### What is Logged\n\n- **MCP Server Operations**: Server initialization, tool calls, and results\n- **File Operations**: Template reads, HTML/PNG generation, PDF creation\n- **Errors**: Detailed error messages with full stack traces\n- **Debug Information**: Template rendering, directory operations, and more\n\n### Log Format\n\nLogs are written in JSON Lines format for easy parsing:\n\n```json\n{\n  \"timestamp\": \"2025-01-15T10:30:45.123Z\",\n  \"level\": \"ERROR\",\n  \"message\": \"Template file not found\",\n  \"data\": {\n    \"errorMessage\": \"getHtml: file /path/to/template.html not exists.\",\n    \"errorName\": \"Error\",\n    \"stack\": \"Error: getHtml: file...\\n    at htmlPlugin.getHtml...\",\n    \"templateFilePath\": \"/path/to/template.html\",\n    \"functionName\": \"createAgendaSlide\"\n  }\n}\n```\n\n### Custom Logger\n\nYou can replace the default logger with your own implementation (e.g., for telemetry):\n\n```typescript\nimport { setLogger, LoggerInterface } from 'mulmocast-vision/logger';\n\nclass CustomLogger implements LoggerInterface {\n  info(message: string, data?: unknown) {\n    // Your implementation\n  }\n  // ... other methods\n}\n\nsetLogger(new CustomLogger());\n```\n\n## For Developers\n\nMulmoCast Vision is open source, so you can apply various designs by modifying the HTML.\nFor adding styles, please refer to [Style.ja.md](https://github.com/receptron/mulmocast-vision/blob/main/Style.ja.md).\n\n### Official Repository & Package\n\n- [GitHub: receptron/mulmocast-vision](https://github.com/receptron/mulmocast-vision)\n- [npm: mulmocast-vision](https://www.npmjs.com/package/mulmocast-vision)\n\n---\n\n# mulmocast-vision（日本語版）\n\n**mulmocast-vision** は、MCP (Model Context Protocol) 経由で LLM を活用し、パワーポイントのようなスライド資料を自動生成できるツールです。\nビジネスに特化した **80種類のスライドテンプレート** を備えており、企画書・提案資料・戦略資料などを簡単に作成できます。\n\n---\n\n## 特徴\n\n- 📑 **豊富なテンプレート**: ビジネスに最適化された 80種類以上のスライドデザイン\n- ⚡ **即時生成**: LLM と MCP を通じて、最短数秒でプレゼン資料を出力\n- 🖥️ **シンプルな利用方法**: MCP対応ツール（例: Claude Desktop）に設定するだけ\n- 📂 **自動保存**: 生成された資料は `~/Documents/mulmocast-vision/` 以下に保存\n\n---\n\n## インストール不要\n\n追加のインストールは不要です。`npx` 経由で直接実行できます。\n\n---\n\n## 設定方法\n\nMCP対応ツール（例: Claude Desktop）の設定ファイルに以下を追記してください。\n\n```json\n\"mulmocast-vision\": {\n  \"command\": \"npx\",\n  \"args\": [\n    \"mulmocast-vision\"\n  ],\n  \"transport\": {\n    \"stdio\": true\n  }\n}\n```\n\n---\n\n## 使い方\n\n1. MCP対応クライアント（Claude Desktop など）を起動\n2. `mulmocast-vision` を呼び出してスライド生成を指示\n3. 完成した資料が自動的に `~/Documents/mulmocast-vision/` に保存されます\n\n---\n\n## 出力例\n\n- 企画書（Problem → Solution → Value → Next Action）\n- ビジネスモデルキャンバス\n- SWOT分析、PEST分析、3C分析\n- サマリースライド、アジェンダスライド、クロージングスライド\n\n---\n\n## ログ機能\n\nmulmocast-visionは、デバッグや監視を支援するため、すべての操作とエラーを自動的にログに記録します。\n\n### ログの保存場所\n\nログは `/tmp/mulmocast-vision-mcp/` に日次ローテーションで保存されます：\n- 形式: `mcp_yyyymmdd.log` (例: `mcp_20251206.log`)\n- 日付が変わると新しいログファイルが作成されます\n\n### 記録される内容\n\n- **MCPサーバー操作**: サーバーの初期化、ツール呼び出し、実行結果\n- **ファイル操作**: テンプレート読み込み、HTML/PNG生成、PDF作成\n- **エラー**: 詳細なエラーメッセージとスタックトレース\n- **デバッグ情報**: テンプレートレンダリング、ディレクトリ操作など\n\n### ログフォーマット\n\nログはJSON Lines形式で記録され、解析が容易です：\n\n```json\n{\n  \"timestamp\": \"2025-01-15T10:30:45.123Z\",\n  \"level\": \"ERROR\",\n  \"message\": \"Template file not found\",\n  \"data\": {\n    \"errorMessage\": \"getHtml: file /path/to/template.html not exists.\",\n    \"errorName\": \"Error\",\n    \"stack\": \"Error: getHtml: file...\\n    at htmlPlugin.getHtml...\",\n    \"templateFilePath\": \"/path/to/template.html\",\n    \"functionName\": \"createAgendaSlide\"\n  }\n}\n```\n\n### カスタムロガー\n\nデフォルトのロガーを独自の実装（テレメトリーなど）に置き換えることができます：\n\n```typescript\nimport { setLogger, LoggerInterface } from 'mulmocast-vision/logger';\n\nclass CustomLogger implements LoggerInterface {\n  info(message: string, data?: unknown) {\n    // 独自の実装\n  }\n  // ... その他のメソッド\n}\n\nsetLogger(new CustomLogger());\n```",
  "bytes": 6578,
  "sha": "c3f1a990a20f05776de883b5fc73a0943ff1633e046577090290b0913c854a4c",
  "repo_slug": "receptron/mulmocast-vision",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_isamu_mulmocast_vision_541e0b58/readme"
}