mulmocast-vision 0.1.0 → 0.1.2

package/README.md

@@ -1,119 +1,112 @@
-# 📖 mulmo vision とは？
+# mulmocast-vision  
 
-mulmo vision は LLM（大規模言語モデル） を使って、プレゼンテーション資料を自動で作成するツールです。
+**mulmocast-vision** is a tool that uses LLMs via MCP (Model Context Protocol) to automatically generate presentation slides, similar to PowerPoint.  
+With **80+ business-oriented slide templates**, you can quickly create proposals, strategy decks, and other professional materials.  
 
-プログラミングやデザインの専門知識がなくても、
-「伝えたい情報」を入力すれば、スライドの文章とデザインが自動生成されます。
+---
 
-# ⚙️ 仕組み
+## Features  
 
-- 情報整理
-ユーザーが資料に入れたい情報をまとめます。
+- 📑 **Rich Templates**: 80 business-optimized slide designs  
+- ⚡ **Instant Generation**: Create slides in seconds using LLMs via MCP  
+- 🖥️ **Simple Setup**: Just add a small config to your MCP client (e.g., Claude Desktop)  
+- 📂 **Auto Save**: Output files are saved under `~/Documents/mulmocast-vision/`  
 
-- スライド設計（LLM）
-LLM が情報を読み取り、必要なスライド構成と文言を決定します。
+---
 
-- HTML テンプレート生成
-Node.js 関数が呼ばれ、スライド用の HTML テンプレートに文言が埋め込まれます。
+## No Installation Needed  
 
-- 画像生成
-HTML をレンダリングし、最終的なスライド画像を作成します。
+Runs directly with `npx`. No global install required.  
 
+---
 
-```mermaid
-flowchart TD
+## Configuration
 
-    A[📝 ユーザーが情報を入力] --> B[🤖 LLM: スライド設計 & 文言作成]
-    B --> C[⚙️ Node 関数: HTML テンプレートに適用]
-    C --> D[🖼 HTML レンダリング: スライド画像生成]
-    D --> E[📑 完成したプレゼン資料]
+Add the following to your MCP client settings (e.g., Claude Desktop):  
+
+```json
+"mulmocast-vision": {
+  "command": "npx",
+  "args": [
+    "mulmocast-vision"
+  ],
+  "transport": {
+    "stdio": true
+  }
+}
 ```
 
+---
 
-# 技術的な流れ
-- LLMがtoolsを使ってスライドの内容を決める
-  - [slideを作成するtoolsの関数定義](./src/tools.ts)
-- [runner](./src/runner.ts)でtoolsの結果から関数を呼び出す
-  - [呼び出される関数](./src/presentationHandlers/html_class.ts)
-- [html + tailwindを使ったベースhtml](./assets/templates/tailwind.html) + [スライドごとの個別のhtml](./assets/html/) でhtmlページをつくる
-- outdirに画像として保存する
+## Usage  
 
+1. Launch an MCP-compatible client (e.g., Claude Desktop)  
+2. Call `mulmocast-vision` to request slide generation  
+3. The generated slides will be saved automatically under `~/Documents/mulmocast-vision/`  
 
-### sample: 80このサンプルデータを使ってhtml -> imageを生成する
+---
 
-```
-yarn run generate_all_images
-```
-- [その関数で生成される80種類のサンプルのデータ](./tests/ai_referencing_80_tool_calls.ts)
+## Output Examples
 
-outdir/{timeStamp}/{index}.png に画像生成
+- Proposal (Problem → Solution → Value → Next Action)
+- Business Model Canvas
+- SWOT, PEST, and 3C Analysis
+- Summary, Agenda, and Closing Slides
 
+---
 
-### openaiのエージェントでprompt -> tools -> html作成
+# mulmocast-vision（日本語版）
 
-```
-yarn run ai
-```
+**mulmocast-vision** は、MCP (Model Context Protocol) 経由で LLM を活用し、パワーポイントのようなスライド資料を自動生成できるツールです。
+ビジネスに特化した **80種類のスライドテンプレート** を備えており、企画書・提案資料・戦略資料などを簡単に作成できます。
 
-プロンプトはソースに直接書いている `src/presentation.ts`
+---
 
+## 特徴
 
-### プラグイン＋デザインテンプレート
+- 📑 **豊富なテンプレート**: ビジネスに最適化された 80種類以上のスライドデザイン
+- ⚡ **即時生成**: LLM と MCP を通じて、最短数秒でプレゼン資料を出力
+- 🖥️ **シンプルな利用方法**: MCP対応ツール（例: Claude Desktop）に設定するだけ
+- 📂 **自動保存**: 生成された資料は `~/Documents/mulmocast-vision/` 以下に保存
 
-デザインは
-- toolsから呼ばれる関数群を変更する(html以外でも書き出せる)
-- htmlのベースファイルに変更、もしくはstyleの追加
-  - assets/templates以下のファイルを書き換える
-  - templateファイルの指定
-    - `const handler = new htmlPlugin({ outputDir, rootDir, templateOptions: {htmlTemplateFile: "tailwind-sea"}});`
-  - templateのheaderへstyleを注入
-    - `const handler = new htmlPlugin({ outputDir, rootDir, templateOptions: {headerStyle: darkStyle}});`
-- 各スライド用の個別のhtmlファイルの変更
-  - `assets/html/` 以下のファイルを編集
-  - 各スライド用のフォルダーを変更する
-    `const templateFileName = path.resolve(this.rootDir, "./assets/html/", `${fileName}.html`);`
+---
 
-することでカスタマイズできます。
+## インストール不要
 
+追加のインストールは不要です。`npx` 経由で直接実行できます。
 
-### mcp
+---
 
-buildする
-```
-yarn run build
-```
+## 設定方法
 
-mcp設定
+MCP対応ツール（例: Claude Desktop）の設定ファイルに以下を追記してください。
 
-for dev
-```
-    "mulmocast-vision": {
-      "command": "npx",
-      "args": [
-        "mulmocast-vision",
-        "page"
-      ],
-      "transport": {
-        "stdio": true
-      }
-    }
+```json
+"mulmocast-vision": {
+  "command": "npx",
+  "args": [
+    "mulmocast-vision"
+  ],
+  "transport": {
+    "stdio": true
+  }
+}
 ```
 
+---
 
-for dev
-```
-    "mulmocast-vision": {
-      "command": "env",
-      "args": [
-        "node",
-        "/path/to/mulmocast-vision/lib/mcp/server.js"
-      ],
-      "transport": {
-        "stdio": true
-      }
-    }
-```
+## 使い方
+
+1. MCP対応クライアント（Claude Desktop など）を起動
+2. `mulmocast-vision` を呼び出してスライド生成を指示
+3. 完成した資料が自動的に `~/Documents/mulmocast-vision/` に保存されます
+
+---
+
+## 出力例
+
+- 企画書（Problem → Solution → Value → Next Action）
+- ビジネスモデルキャンバス
+- SWOT分析、PEST分析、3C分析
+- サマリースライド、アジェンダスライド、クロージングスライド
 
-mulmocast-vision/output以下に画像が出力される。
-セッションごとにfolderができるので注意
-(連続すると画像が上書きされるかも)

package/lib/browser.d.ts

@@ -1,2 +1,3 @@
 export * from "./tools";
 export * from "./commons";
+export * from "./type";

package/lib/browser.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./tools"), exports);
 __exportStar(require("./commons"), exports);
+__exportStar(require("./type"), exports);

package/lib/commons.d.ts

@@ -6,11 +6,7 @@ export declare const openAIToolsToAnthropicTools: (tools: OpenAITool[]) => {
     tools: {
         name: string;
         description: string;
-        inputSchema: {
-            type: string;
-            required: string[];
-            properties: Record<string, unknown>;
-        };
+        inputSchema: import("./type").ToolParametersSchema;
     }[];
 };
 export declare const convertTools: (tools: OpenAITool[]) => {

package/lib/mcp/core.js

@@ -5,7 +5,6 @@ exports.getServer = void 0;
 const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
 const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const tools_1 = require("../tools");
-const mcp_tools_1 = require("../mcp_tools");
 const html_class_1 = require("../presentationHandlers/html_class");
 const commons_1 = require("../commons");
 const getServer = (rootDir, outputDir) => {
@@ -19,30 +18,26 @@ const getServer = (rootDir, outputDir) => {
     });
     // List available tools
     server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
-        return (0, commons_1.openAIToolsToAnthropicTools)([...tools_1.tools, ...mcp_tools_1.mcp_tools]);
+        return (0, commons_1.openAIToolsToAnthropicTools)([...tools_1.tools, ...tools_1.mcp_tools]);
     });
     const handler = new html_class_1.htmlPlugin({ outputDir, rootDir });
     // Handle tool calls
     server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
         try {
-            if (name in handler && args) {
-                const key = name;
-                const method = handler[key];
-                if (typeof method === "function") {
-                    const fileName = (0, commons_1.generateUniqueId)();
-                    const result = await method(args, { functionName: name, outputFileName: fileName });
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: result?.text ?? "success",
-                            },
-                        ],
-                    };
-                }
+            if (args) {
+                const fileName = (0, commons_1.generateUniqueId)();
+                const result = await handler.callNamedFunction(name, args, { outputFileName: fileName });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: result?.text ?? "success",
+                        },
+                    ],
+                };
             }
-            throw new Error(`Unknown command: ${name}.`);
+            throw new Error(`No args: ${name}.`);
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);

package/lib/mcp_tools.d.ts

@@ -1,35 +1,2 @@
-export declare const mcp_tools: ({
-    type: string;
-    function: {
-        name: string;
-        description: string;
-        parameters: {
-            type: string;
-            properties: {
-                directoryName: {
-                    type: string;
-                    description: string;
-                };
-                status?: undefined;
-            };
-            required: string[];
-        };
-    };
-} | {
-    type: string;
-    function: {
-        name: string;
-        description: string;
-        parameters: {
-            type: string;
-            properties: {
-                status: {
-                    type: string;
-                    description: string;
-                };
-                directoryName?: undefined;
-            };
-            required: string[];
-        };
-    };
-})[];
+import { OpenAITool } from "./type";
+export declare const mcp_tools: OpenAITool[];

package/lib/presentationHandlers/html.d.ts

@@ -1,82 +1,3 @@
 import { type PluginOptionParams, type ToolArgs } from "../type";
 export declare const baseDir: string;
-export declare const createSectionDividerPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createAgendaPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createExecutiveSummaryPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createKeyMessageWithSupportsPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createHypothesisPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createIssueTreePage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createDriverTreePage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createMeceListPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createPyramidPrinciplePage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createScqaPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createSwotPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createThreeCPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createFourPPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createSevenSPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createValueChainPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createPorterFiveForcesPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createBusinessModelCanvasPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createCustomerJourneyPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createStakeholderMapPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createRaciPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createOkrKpiDashboardPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createBalancedScorecardPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createQuarterlyRoadmapPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createMilestoneTimelinePage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createGanttSimplePage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createWaterfallPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createFunnelPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createTwoByTwoMatrixPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createBcgMatrixPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createGeMcKinseyMatrixPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createMarimekkoPlaceholderPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createBubbleChartPlaceholderPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createHeatmapPlaceholderPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createKpiHighlightPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createBeforeAfterPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createOptionEvaluationPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createRiskMitigationPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createPositioningMapPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createTamSamSomPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createMarketDriversPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createRevenueModelPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createCostStructurePage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createOrgChartPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createCapabilityMaturityPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createTechRoadmapPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createDigitalMaturityPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createEcosystemMapPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createChangeCurvePage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createCommunicationPlanPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createIntegrationPlanPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createBenchmarkingTablePage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createSurveyResultsPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createPersonasPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createSegmentationPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createPricingWaterfallPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createSensitivityAnalysisPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createPLBreakdownPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createCashFlowPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createBalanceSheetPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createShareholderValueTreePage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createNpvSummaryPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createScenarioPlanningPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createComplianceHeatmapPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createEsgFrameworkPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createCsrInitiativesPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createSustainabilityRoadmapPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createCircularEconomyMapPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createInnovationFunnelPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createProductRoadmapPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createLaunchPlanPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createPipelineFunnelPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createSalesDashboardPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createMarketingMixPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createCustomerSuccessJourneyPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createSupportOrgModelPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createPartnershipMapPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createMAPipelinePage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createSynergyCapturePage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createCultureValuesPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
-export declare const createThankYouContactPage: (args: ToolArgs, options: PluginOptionParams) => Promise<void>;
+export declare const callNamedFunction: (functionName: string, args: ToolArgs, options: PluginOptionParams) => Promise<void>;