@masaki39/marp-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 masaki39
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,347 @@
+# Marp MCP Server
+
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for managing [Marp](https://marp.app/) presentation projects with academic theme support. Optimized for use with Claude Code, Cursor, and other AI-powered editors.
+
+## Features
+
+- 🎨 **Academic Theme Support** - Pre-configured academic_custom.css theme
+- 📁 **Project Initialization** - Automatic directory structure setup
+- 🎯 **Structured Slide Generation** - 6 layout templates for consistent design
+- 🔧 **Editor Integration** - Designed for Claude Code and Cursor
+- 📝 **Markdown Output** - Generate slides as markdown strings for easy editing
+
+## Installation
+
+### Via npx (Recommended)
+
+```bash
+npx @masaki39/marp-mcp
+```
+
+### Global Installation
+
+```bash
+npm install -g @masaki39/marp-mcp
+```
+
+### Local Installation
+
+```bash
+npm install @masaki39/marp-mcp
+```
+
+## Configuration
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "marp": {
+      "command": "npx",
+      "args": ["-y", "@masaki39/marp-mcp"]
+    }
+  }
+}
+```
+
+Or with global installation:
+
+```json
+{
+  "mcpServers": {
+    "marp": {
+      "command": "marp-mcp"
+    }
+  }
+}
+```
+
+### Claude Code / Cursor
+
+The server works seamlessly with Claude Code and Cursor. The generated markdown can be directly inserted into your editor.
+
+## Available Tools
+
+### 1. `init_presentation`
+
+Initialize a new Marp presentation project with complete directory structure.
+
+**Parameters:**
+- `projectPath` (string) - Directory where project will be created
+- `projectName` (string) - Name of the presentation project
+- `presentationTitle` (string) - Title of the presentation
+- `presentationSubtitle` (string, optional) - Subtitle
+- `description` (string, optional) - Brief description
+
+**Generated Structure:**
+```
+my-presentation/
+├── slides.md                    # Main presentation file
+├── themes/
+│   └── academic_custom.css      # Academic theme
+├── attachments/
+│   ├── images/                  # Image files
+│   ├── videos/                  # Video files
+│   └── data/                    # Data files
+├── .gitignore
+└── README.md
+```
+
+**Example:**
+```javascript
+{
+  "projectPath": "/Users/yourname/presentations",
+  "projectName": "research-2024",
+  "presentationTitle": "Research Findings",
+  "presentationSubtitle": "Annual Report 2024",
+  "description": "Research results presentation"
+}
+```
+
+### 2. `generate_slide`
+
+Generate a slide using academic theme layouts. Returns markdown string for copy-paste.
+
+**Parameters:**
+- `layoutType` (string) - Layout type (title, lead, content, table, multi-column, quote)
+- `params` (object) - Layout-specific parameters
+
+**Example:**
+```javascript
+{
+  "layoutType": "title",
+  "params": {
+    "title": "Presentation Title",
+    "subtitle": "Subtitle"
+  }
+}
+```
+
+### 3. `list_slide_layouts`
+
+List all available slide layouts with their parameters and descriptions.
+
+**No parameters required.**
+
+## Available Layouts
+
+### Title Slide (`title`)
+Centered title and subtitle with `.title` class.
+
+**Parameters:**
+- `title` (required, max 60 chars)
+- `subtitle` (optional, max 100 chars)
+
+**Output:**
+```markdown
+# Presentation Title
+## Subtitle
+
+<!-- _class: title -->
+```
+
+### Lead Slide (`lead`)
+Left-aligned with maroon color headings using `.lead` class.
+
+**Parameters:**
+- `heading` (required, max 80 chars)
+- `content` (optional, markdown supported)
+
+**Output:**
+```markdown
+# Main Heading
+
+Content goes here
+
+<!-- _class: lead -->
+```
+
+### Content Slide (`content`)
+Standard content slide with optional heading.
+
+**Parameters:**
+- `heading` (optional, max 80 chars)
+- `content` (required, markdown supported)
+
+**Output:**
+```markdown
+# Heading
+
+Content with markdown support
+- List item 1
+- List item 2
+```
+
+### Table Slide (`table`)
+Table with customizable size and alignment.
+
+**Parameters:**
+- `heading` (optional, max 80 chars)
+- `tableMarkdown` (required, markdown table)
+- `tableClass` (optional: "center", "100", "tiny", "small", "large")
+
+**Output:**
+```markdown
+# Table Heading
+
+| Column 1 | Column 2 |
+|----------|----------|
+| Data 1   | Data 2   |
+
+<!-- _class: table-center table-100 -->
+```
+
+### Multi-Column Slide (`multi-column`)
+2-3 column layout using double blockquote syntax.
+
+**Parameters:**
+- `heading` (optional, max 80 chars)
+- `columns` (required, array of strings)
+
+**Output:**
+```markdown
+# Comparison
+
+> > Column 1 content
+> > - Point 1
+>
+> > Column 2 content
+> > - Point 2
+```
+
+### Quote Slide (`quote`)
+Quote with citation in footer.
+
+**Parameters:**
+- `heading` (optional, max 80 chars)
+- `content` (optional)
+- `quote` (required, max 300 chars)
+- `citation` (optional, max 100 chars)
+
+**Output:**
+```markdown
+# Heading
+
+Main content
+
+> Quote text here — Citation
+```
+
+## Academic Theme Features
+
+The included `academic_custom.css` theme provides:
+
+- **Page numbering** - Automatic slide numbers
+- **Custom fonts** - Noto Sans JP and Source Code Pro
+- **Color scheme** - Maroon highlights (#800000)
+- **Table styles** - Multiple size and alignment options
+- **Multi-column support** - Flexible column layouts
+- **Header support** - Customizable presentation headers
+
+### CSS Classes
+
+- `.title` - Title slide (centered)
+- `.lead` - Lead slide (left-aligned, maroon)
+- `.table-center` - Centered table
+- `.table-100` - Full-width table
+- `.table-tiny` - Small font table (0.7em)
+- `.table-small` - Small font table (0.8em)
+- `.table-large` - Large font table (1.1em)
+
+## Building Presentations
+
+### Prerequisites
+
+Install Marp CLI:
+
+```bash
+npm install -g @marp-team/marp-cli
+```
+
+### Build to PDF
+
+```bash
+marp slides.md -o slides.pdf
+```
+
+### Build to HTML
+
+```bash
+marp slides.md -o slides.html
+```
+
+### Build to PowerPoint
+
+```bash
+marp slides.md -o slides.pptx
+```
+
+### Preview in VS Code
+
+Install [Marp for VS Code](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode) extension for live preview.
+
+## Development
+
+### Building from Source
+
+```bash
+git clone https://github.com/masaki39/marp-mcp.git
+cd marp-mcp
+npm install
+npm run build
+```
+
+### Testing Locally
+
+```bash
+npm link
+```
+
+Then configure Claude Desktop to use the local version.
+
+## Troubleshooting
+
+### Server Not Starting
+
+Check logs in `~/Library/Logs/Claude/`:
+```bash
+tail -f ~/Library/Logs/Claude/mcp*.log
+```
+
+### Template Files Not Found
+
+Ensure the package was built correctly:
+```bash
+npm run build
+ls build/templates/
+```
+
+Should show:
+- `academic_custom.css`
+- `slides.template.md`
+- `README.template.md`
+- `gitignore.template`
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Credits
+
+- Academic theme based on [marp-theme-academic](https://github.com/kaisugi/marp-theme-academic) by kaisugi
+- Built on [Model Context Protocol](https://modelcontextprotocol.io)
+- Powered by [Marp](https://marp.app/)
+
+## Links
+
+- [GitHub Repository](https://github.com/masaki39/marp-mcp)
+- [npm Package](https://www.npmjs.com/package/@masaki39/marp-mcp)
+- [Marp Documentation](https://marpit.marp.app/)
+- [MCP Documentation](https://modelcontextprotocol.io)

package/build/index.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * Marp MCP Server
+ * A Model Context Protocol server for managing Marp presentation projects
+ * Optimized for Claude Code and Cursor
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+// Import tools
+import { initPresentationSchema, initPresentation } from "./tools/init.js";
+import { generateSlideSchema, generateSlide, listSlideLayoutsSchema, listSlideLayouts, } from "./tools/generate.js";
+// Create server instance
+const server = new McpServer({
+    name: "marp-mcp",
+    version: "2.0.0",
+    capabilities: {
+        resources: {},
+        tools: {},
+    },
+});
+// Register tools
+server.tool("init_presentation", "Initialize a new Marp presentation project with directory structure, theme, and templates", initPresentationSchema.shape, initPresentation);
+server.tool("generate_slide", "Generate a slide using academic theme layouts (returns markdown string for copy-paste)", generateSlideSchema.shape, generateSlide);
+server.tool("list_slide_layouts", "List all available slide layouts with their parameters and descriptions", listSlideLayoutsSchema.shape, listSlideLayouts);
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Marp MCP Server v2.0 running on stdio");
+    console.error("Optimized for Claude Code and Cursor");
+    console.error("Tools: init_presentation, generate_slide, list_slide_layouts");
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    process.exit(1);
+});

package/build/layouts/academic.js

@@ -0,0 +1,258 @@
+/**
+ * Academic theme layout definitions
+ * Based on academic_custom.css theme
+ */
+/**
+ * Title slide layout - centered title and subtitle
+ */
+export const titleLayout = {
+    name: "title",
+    description: "Title slide with centered title and subtitle",
+    className: "title",
+    params: {
+        title: {
+            type: "string",
+            description: "Main title",
+            required: true,
+            maxLength: 60,
+        },
+        subtitle: {
+            type: "string",
+            description: "Subtitle",
+            required: false,
+            maxLength: 100,
+        },
+    },
+    template: (params) => {
+        let slide = `# ${params.title}\n`;
+        if (params.subtitle) {
+            slide += `## ${params.subtitle}\n`;
+        }
+        slide += `\n<!-- _class: title -->`;
+        return slide;
+    },
+};
+/**
+ * Lead slide layout - left-aligned with maroon color
+ */
+export const leadLayout = {
+    name: "lead",
+    description: "Lead slide with left-aligned maroon headings",
+    className: "lead",
+    params: {
+        heading: {
+            type: "string",
+            description: "Main heading",
+            required: true,
+            maxLength: 80,
+        },
+        content: {
+            type: "string",
+            description: "Content (markdown supported)",
+            required: false,
+        },
+    },
+    template: (params) => {
+        let slide = `# ${params.heading}\n`;
+        if (params.content) {
+            slide += `\n${params.content}\n`;
+        }
+        slide += `\n<!-- _class: lead -->`;
+        return slide;
+    },
+};
+/**
+ * Default content slide
+ */
+export const contentLayout = {
+    name: "content",
+    description: "Standard content slide with optional heading",
+    params: {
+        heading: {
+            type: "string",
+            description: "Slide heading",
+            required: false,
+            maxLength: 80,
+        },
+        content: {
+            type: "string",
+            description: "Content (markdown supported)",
+            required: true,
+        },
+    },
+    template: (params) => {
+        let slide = "";
+        if (params.heading) {
+            slide += `# ${params.heading}\n\n`;
+        }
+        slide += params.content;
+        return slide;
+    },
+};
+/**
+ * Table slide layout with various size/alignment options
+ */
+export const tableLayout = {
+    name: "table",
+    description: "Table slide with customizable size and alignment",
+    params: {
+        heading: {
+            type: "string",
+            description: "Slide heading",
+            required: false,
+            maxLength: 80,
+        },
+        tableMarkdown: {
+            type: "string",
+            description: "Table in markdown format",
+            required: true,
+        },
+        tableClass: {
+            type: "string",
+            description: "Table class: center, 100, tiny, small, large (can combine with spaces)",
+            required: false,
+        },
+    },
+    template: (params) => {
+        let slide = "";
+        if (params.heading) {
+            slide += `# ${params.heading}\n\n`;
+        }
+        slide += params.tableMarkdown;
+        // Build class string
+        const classes = [];
+        if (params.tableClass) {
+            const tableOpts = params.tableClass.split(/\s+/);
+            tableOpts.forEach((opt) => {
+                if (opt === "center")
+                    classes.push("table-center");
+                else if (opt === "100")
+                    classes.push("table-100");
+                else if (["tiny", "small", "large"].includes(opt))
+                    classes.push(`table-${opt}`);
+            });
+        }
+        if (classes.length > 0) {
+            slide += `\n\n<!-- _class: ${classes.join(" ")} -->`;
+        }
+        return slide;
+    },
+};
+/**
+ * Multi-column layout using double blockquote syntax
+ */
+export const multiColumnLayout = {
+    name: "multi-column",
+    description: "Multi-column layout (2-3 columns) using double blockquote",
+    params: {
+        heading: {
+            type: "string",
+            description: "Slide heading",
+            required: false,
+            maxLength: 80,
+        },
+        columns: {
+            type: "array",
+            description: "Array of column contents (markdown supported)",
+            required: true,
+        },
+    },
+    template: (params) => {
+        let slide = "";
+        if (params.heading) {
+            slide += `# ${params.heading}\n\n`;
+        }
+        // Generate double blockquote for each column
+        const columns = params.columns;
+        const columnBlocks = columns.map((col) => {
+            const lines = col.trim().split("\n");
+            return lines.map((line) => `> > ${line}`).join("\n");
+        });
+        slide += columnBlocks.join("\n>\n");
+        return slide;
+    },
+};
+/**
+ * Quote/citation slide with footer blockquote
+ */
+export const quoteLayout = {
+    name: "quote",
+    description: "Quote slide with citation in footer",
+    params: {
+        heading: {
+            type: "string",
+            description: "Slide heading",
+            required: false,
+            maxLength: 80,
+        },
+        content: {
+            type: "string",
+            description: "Main content before quote",
+            required: false,
+        },
+        quote: {
+            type: "string",
+            description: "Quote text",
+            required: true,
+            maxLength: 300,
+        },
+        citation: {
+            type: "string",
+            description: "Citation/source",
+            required: false,
+            maxLength: 100,
+        },
+    },
+    template: (params) => {
+        let slide = "";
+        if (params.heading) {
+            slide += `# ${params.heading}\n\n`;
+        }
+        if (params.content) {
+            slide += `${params.content}\n\n`;
+        }
+        // Footer blockquote
+        slide += `> ${params.quote}`;
+        if (params.citation) {
+            slide += ` — ${params.citation}`;
+        }
+        return slide;
+    },
+};
+/**
+ * All available layouts
+ */
+export const academicLayouts = {
+    title: titleLayout,
+    lead: leadLayout,
+    content: contentLayout,
+    table: tableLayout,
+    "multi-column": multiColumnLayout,
+    quote: quoteLayout,
+};
+/**
+ * Get layout by name
+ */
+export function getLayout(name) {
+    return academicLayouts[name] || null;
+}
+/**
+ * Get all layout names
+ */
+export function getLayoutNames() {
+    return Object.keys(academicLayouts);
+}
+/**
+ * Get all layouts info
+ */
+export function getAllLayoutsInfo() {
+    return Object.entries(academicLayouts).map(([name, layout]) => ({
+        name,
+        description: layout.description,
+        className: layout.className,
+        params: Object.entries(layout.params).map(([paramName, paramDef]) => ({
+            name: paramName,
+            ...paramDef,
+        })),
+    }));
+}

package/build/templates/README.template.md

@@ -0,0 +1,67 @@
+# {{PRESENTATION_TITLE}}
+
+{{PRESENTATION_DESCRIPTION}}
+
+## ディレクトリ構造
+
+```
+.
+├── slides.md              # メインスライド
+├── themes/
+│   └── academic_custom.css  # カスタムテーマ
+├── attachments/
+│   ├── images/           # 画像ファイル
+│   ├── videos/           # 動画ファイル
+│   └── data/             # データファイル
+└── README.md             # このファイル
+```
+
+## ビルド方法
+
+### PDF出力
+\`\`\`bash
+marp slides.md -o slides.pdf
+\`\`\`
+
+### HTML出力
+\`\`\`bash
+marp slides.md -o slides.html
+\`\`\`
+
+### プレビュー（VSCode拡張）
+Marp for VS Code拡張をインストールして、`slides.md`を開くとプレビューが表示されます。
+
+## テーマについて
+
+このプロジェクトでは`academic_custom`テーマを使用しています。
+
+### 利用可能なクラス
+
+- `.title` - タイトルスライド（中央揃え）
+- `.lead` - リードスライド（左揃え、マルーン色）
+- `.table-center` - テーブル中央揃え
+- `.table-100` - テーブル幅100%
+- `.table-tiny/small/large` - テーブルサイズ調整
+
+### マルチカラムの使い方
+
+二重blockquote記法を使用します：
+
+\`\`\`markdown
+> > 左カラムの内容
+> > - リスト1
+>
+> > 右カラムの内容
+> > - リスト2
+\`\`\`
+
+## アセットの配置
+
+- 画像: `attachments/images/`
+- 動画: `attachments/videos/`
+- データ: `attachments/data/`
+
+画像の参照例：
+\`\`\`markdown
+![説明](./attachments/images/example.png)
+\`\`\`

package/build/templates/academic_custom.css

@@ -0,0 +1,160 @@
+/* @theme academic */
+/* Author: kaisugi https://github.com/kaisugi/ */
+/* MIT license https://github.com/kaisugi/marp-theme-academic/blob/main/LICENSE */
+
+@import 'gaia';
+@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+JP:wght@400;700&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=Source+Code+Pro&display=swap');
+
+:root {
+  --color-background: #fff;
+  --color-foreground: #333;
+  --color-highlight: #800000;
+}
+
+section {
+  background-image: none;
+  font-family: 'Noto Sans JP', sans-serif;
+  padding-top: 90px;
+  padding-left: 40px;
+  padding-right: 40px;
+}
+
+/* https://github.com/marp-team/marpit/issues/271 */
+section::after {
+  font-weight: 700;
+  content: attr(data-marpit-pagination) '/' attr(data-marpit-pagination-total);
+}
+
+ul ul {
+  font-size: 0.9em;
+}
+
+section.lead h1 {
+  color: #800000;
+  text-align: left;
+}
+section.lead h1 strong {
+  -webkit-text-stroke: 1px #800000;
+}
+section.lead h2 {
+  color: #800000;
+  text-align: left;
+}
+section.lead h2 strong {
+  -webkit-text-stroke: 1px #800000;
+}
+section.lead h3 {
+  color: #800000;
+  text-align: left;
+}
+section.lead h3 strong {
+  -webkit-text-stroke: 1px #800000;
+}
+section.lead h4 {
+  color: #800000;
+  text-align: left;
+}
+section.lead h4 strong {
+  -webkit-text-stroke: 1px #800000;
+}
+section.lead h5 {
+  color: #800000;
+  text-align: left;
+}
+section.lead h5 strong {
+  -webkit-text-stroke: 1px #800000;
+}
+section.lead p {
+  text-align: right;
+}
+
+header {
+  background-color: #800000;
+  color: #fff;
+  font-size: 1em;
+  font-weight: 700;
+}
+
+section > blockquote:not(:has(blockquote)) {
+  max-width: 90%;
+  border-top: 0.1em dashed #555;
+  font-size: 60%;
+  position: absolute;
+  bottom: 20px;
+}
+blockquote::before {
+  content: "";
+}
+blockquote::after {
+  content: "";
+}
+
+img[alt~="center"] {
+  display: block;
+  margin: 0 auto;
+}
+
+code {
+  font-family: 'Source Code Pro', monospace;
+}
+
+/*academicに追記*/
+
+/* タイトルクラス */
+section.title {
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+}
+
+section.title h1 {
+  text-align: center;
+}
+
+section.title h2 {
+  text-align: center;
+}
+
+/* tableクラス */
+section.table-100 table {
+  width: 100%;
+  text-align: center;
+}
+
+section.table-center table {
+  margin: 0 auto;
+  margin-top: 15px;
+}
+
+section.table-tiny table {
+  font-size: 0.7em;
+}
+
+section.table-small table {
+  font-size: 0.8em;
+}
+
+section.table-large table {
+  font-size: 1.1em;
+}
+
+/* 二重ブロッククオート記法でのマルチコラム設定 */
+section blockquote:has(blockquote) {
+  display: flex;
+  flex-direction: row;
+  gap: 10px;
+  align-items: flex-start;
+}
+
+/* blockquoteのみをflexアイテムに（安全な方法） */
+section blockquote > blockquote {
+  flex: 1;
+  margin: 0;
+  padding: 0;
+}
+
+/* 内側blockquoteの中身を通常のブロック表示に */
+section blockquote > blockquote * {
+  display: revert; /* 元の表示方式に戻す */
+}

package/build/templates/gitignore.template

@@ -0,0 +1,20 @@
+# Marp build outputs
+*.pdf
+*.html
+*.pptx
+dist/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Temporary files
+*.tmp
+*.log

package/build/templates/slides.template.md

@@ -0,0 +1,30 @@
+---
+marp: true
+theme: academic_custom
+size: 16:9
+paginate: true
+header: '{{PRESENTATION_TITLE}}'
+---
+
+<!-- _class: title -->
+
+# {{PRESENTATION_TITLE}}
+## {{PRESENTATION_SUBTITLE}}
+
+---
+
+# はじめに
+
+プレゼンテーションの内容をここに記述します。
+
+- ポイント1
+- ポイント2
+- ポイント3
+
+---
+
+# まとめ
+
+まとめの内容をここに記述します。
+
+> 引用や注釈はこのように記述します

package/build/tools/generate.js

@@ -0,0 +1,127 @@
+/**
+ * Tool: generate_slide
+ * Generate a slide using academic theme layouts
+ */
+import { z } from "zod";
+import { getLayout, getLayoutNames } from "../layouts/academic.js";
+export const generateSlideSchema = z.object({
+    layoutType: z.string().describe("Layout type to use (title, lead, content, table, multi-column, quote)"),
+    params: z.record(z.any()).describe("Parameters for the layout template"),
+});
+export async function generateSlide({ layoutType, params, }) {
+    const layout = getLayout(layoutType);
+    if (!layout) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: Unknown layout type "${layoutType}". Available layouts: ${getLayoutNames().join(", ")}`,
+                },
+            ],
+        };
+    }
+    // Validate required parameters
+    const missingParams = [];
+    for (const [paramName, paramDef] of Object.entries(layout.params)) {
+        if (paramDef.required && !params[paramName]) {
+            missingParams.push(paramName);
+        }
+    }
+    if (missingParams.length > 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: Missing required parameters: ${missingParams.join(", ")}`,
+                },
+            ],
+        };
+    }
+    // Validate parameter types and lengths
+    for (const [paramName, value] of Object.entries(params)) {
+        const paramDef = layout.params[paramName];
+        if (!paramDef)
+            continue;
+        // Check type for string parameters
+        if (paramDef.type === "string" && typeof value !== "string") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: Parameter "${paramName}" must be a string`,
+                    },
+                ],
+            };
+        }
+        // Check type for array parameters
+        if (paramDef.type === "array" && !Array.isArray(value)) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: Parameter "${paramName}" must be an array`,
+                    },
+                ],
+            };
+        }
+        // Check max length for string parameters
+        if (paramDef.type === "string" && paramDef.maxLength && typeof value === "string") {
+            if (value.length > paramDef.maxLength) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: Parameter "${paramName}" exceeds maximum length of ${paramDef.maxLength} characters (current: ${value.length})`,
+                        },
+                    ],
+                };
+            }
+        }
+    }
+    // Generate slide content
+    try {
+        const slideContent = layout.template(params);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        layoutType,
+                        markdown: slideContent,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error generating slide: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+        };
+    }
+}
+/**
+ * Tool: list_slide_layouts
+ * List all available slide layouts with their parameters
+ */
+export const listSlideLayoutsSchema = z.object({});
+export async function listSlideLayouts() {
+    const { getAllLayoutsInfo } = await import("../layouts/academic.js");
+    const layoutsInfo = getAllLayoutsInfo();
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    theme: "academic",
+                    layouts: layoutsInfo,
+                }, null, 2),
+            },
+        ],
+    };
+}

package/build/tools/init.js

@@ -0,0 +1,100 @@
+/**
+ * Tool: init_presentation
+ * Initialize a Marp presentation project directory structure
+ */
+import { z } from "zod";
+import { promises as fs } from "fs";
+import path from "path";
+// Import templates as strings
+import { fileURLToPath } from "url";
+import { dirname } from "path";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export const initPresentationSchema = z.object({
+    projectPath: z.string().describe("Path where the project directory will be created"),
+    projectName: z.string().describe("Name of the presentation project"),
+    presentationTitle: z.string().describe("Title of the presentation"),
+    presentationSubtitle: z.string().optional().describe("Subtitle of the presentation"),
+    description: z.string().optional().describe("Brief description of the presentation"),
+});
+export async function initPresentation({ projectPath, projectName, presentationTitle, presentationSubtitle, description, }) {
+    try {
+        // Create project directory
+        const fullPath = path.resolve(projectPath, projectName);
+        // Check if directory already exists
+        try {
+            await fs.access(fullPath);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: Directory already exists at ${fullPath}`,
+                    },
+                ],
+            };
+        }
+        catch {
+            // Directory doesn't exist, proceed
+        }
+        // Create directory structure
+        await fs.mkdir(fullPath, { recursive: true });
+        await fs.mkdir(path.join(fullPath, "themes"), { recursive: true });
+        await fs.mkdir(path.join(fullPath, "attachments", "images"), { recursive: true });
+        await fs.mkdir(path.join(fullPath, "attachments", "videos"), { recursive: true });
+        await fs.mkdir(path.join(fullPath, "attachments", "data"), { recursive: true });
+        // Read template files
+        const templatesDir = path.join(__dirname, "..", "templates");
+        const cssTemplate = await fs.readFile(path.join(templatesDir, "academic_custom.css"), "utf-8");
+        let slidesTemplate = await fs.readFile(path.join(templatesDir, "slides.template.md"), "utf-8");
+        let readmeTemplate = await fs.readFile(path.join(templatesDir, "README.template.md"), "utf-8");
+        const gitignoreTemplate = await fs.readFile(path.join(templatesDir, "gitignore.template"), "utf-8");
+        // Replace placeholders
+        slidesTemplate = slidesTemplate
+            .replace(/\{\{PRESENTATION_TITLE\}\}/g, presentationTitle)
+            .replace(/\{\{PRESENTATION_SUBTITLE\}\}/g, presentationSubtitle || "");
+        readmeTemplate = readmeTemplate
+            .replace(/\{\{PRESENTATION_TITLE\}\}/g, presentationTitle)
+            .replace(/\{\{PRESENTATION_DESCRIPTION\}\}/g, description || "");
+        // Write files
+        await fs.writeFile(path.join(fullPath, "themes", "academic_custom.css"), cssTemplate);
+        await fs.writeFile(path.join(fullPath, "slides.md"), slidesTemplate);
+        await fs.writeFile(path.join(fullPath, "README.md"), readmeTemplate);
+        await fs.writeFile(path.join(fullPath, ".gitignore"), gitignoreTemplate);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        message: `Successfully initialized presentation project at ${fullPath}`,
+                        structure: {
+                            root: fullPath,
+                            files: [
+                                "slides.md",
+                                "README.md",
+                                ".gitignore",
+                                "themes/academic_custom.css",
+                            ],
+                            directories: [
+                                "themes/",
+                                "attachments/images/",
+                                "attachments/videos/",
+                                "attachments/data/",
+                            ],
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error initializing presentation: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+        };
+    }
+}

package/build/types.js

@@ -0,0 +1,4 @@
+/**
+ * Type definitions for Marp MCP Server
+ */
+export {};

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@masaki39/marp-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Marp presentation management with academic theme support",
+  "main": "./build/index.js",
+  "type": "module",
+  "bin": {
+    "marp-mcp": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc && cp -r src/templates build/ && chmod 755 build/index.js",
+    "prepublishOnly": "npm run build",
+    "prepare": "npm run build"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "mcp",
+    "marp",
+    "presentation",
+    "slides",
+    "markdown",
+    "model-context-protocol",
+    "claude",
+    "academic-theme"
+  ],
+  "author": "masaki39",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/masaki39/marp-mcp.git"
+  },
+  "homepage": "https://github.com/masaki39/marp-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/masaki39/marp-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.19.1",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.2",
+    "typescript": "^5.9.3"
+  }
+}