@masaki39/marp-mcp 0.1.0 → 0.3.0

package/README.md

@@ -1,45 +1,15 @@
 # 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.
+An MCP server for creating and editing Marp presentations with AI assistance.
 
-## Features
+## Setup
 
-- 🎨 **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`:
+Add to your MCP client configuration:
 
 ```json
 {
   "mcpServers": {
-    "marp": {
+    "marp-mcp": {
       "command": "npx",
       "args": ["-y", "@masaki39/marp-mcp"]
     }
@@ -47,301 +17,44 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
-Or with global installation:
+## Tools
 
-```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.**
+| Tool | Description |
+|------|-------------|
+| `list_layouts` | List all available slide layouts with parameters and descriptions |
+| `manage_slide` | Insert, replace, or delete slides in a Marp markdown file |
 
 ## 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)
+| Layout | Description |
+|--------|-------------|
+| `title` | Title slide with left-aligned heading and metadata |
+| `section` | Section divider with centered title and subtitle |
+| `list` | Content slide with heading and bullet points or text |
+| `table` | Table layout with customizable size and alignment |
+| `two-column` | Two-column layout for side-by-side content |
+| `image-right` | Layout with image on the right side |
+| `image-center` | Centered image layout with adjustable dimensions |
 
-**Output:**
-```markdown
-# Main Heading
+## Example
 
-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
-```
+See the [example presentation](./assets/example.html) demonstrating all available layouts.
 
-### Table Slide (`table`)
-Table with customizable size and alignment.
+The example was created entirely using this MCP server and showcases:
+- Title and section slides
+- List and table layouts
+- Two-column layout
+- Image layouts (center and right)
 
-**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.
+Source: [example.md](./assets/example.md)
 
 ## 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/)
+MIT License
 
 ## 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)
+- [GitHub](https://github.com/masaki39/marp-mcp)
+- [npm](https://www.npmjs.com/package/@masaki39/marp-mcp)
+- [Marp](https://marp.app/)
+- [Model Context Protocol](https://modelcontextprotocol.io)

package/build/index.js

@@ -7,28 +7,26 @@
 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";
+import { listLayoutsSchema, listLayouts, } from "./tools/list_layouts.js";
+import { manageSlideSchema, manageSlide, } from "./tools/manage_slide.js";
 // Create server instance
 const server = new McpServer({
     name: "marp-mcp",
-    version: "2.0.0",
+    version: "0.3.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);
+server.tool("list_layouts", "ALWAYS read this first before creating Marp slides - lists all available layouts with parameters and descriptions", listLayoutsSchema.shape, listLayouts);
+server.tool("manage_slide", "Create slides using this tool with appropriate layouts, then fine-tune by direct editing if needed", manageSlideSchema.shape, manageSlide);
 // 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");
+    console.error("Marp MCP Server v0.3.0 running on stdio");
+    console.error("Tools: list_layouts, manage_slide");
 }
 main().catch((error) => {
     console.error("Fatal error in main():", error);

package/build/layouts/content.js

@@ -0,0 +1,41 @@
+/**
+ * Default content slide
+ */
+export const contentLayout = {
+    name: "content",
+    description: "Standard content slide with optional h2 heading",
+    params: {
+        heading: {
+            type: "string",
+            description: "Slide heading (max 80 chars, displays as h2)",
+            required: false,
+            maxLength: 80,
+        },
+        content: {
+            type: "string",
+            description: "Content (markdown supported, keep concise - max 800 chars recommended)",
+            required: true,
+            maxLength: 1500,
+        },
+        citations: {
+            type: "array",
+            description: "Citations/references (array of strings)",
+            required: false,
+        },
+    },
+    template: (params) => {
+        let slide = "";
+        if (params.heading) {
+            slide += `## ${params.heading}\n\n`;
+        }
+        slide += params.content;
+        // Add citations
+        if (params.citations && params.citations.length > 0) {
+            slide += '\n\n';
+            params.citations.forEach((citation) => {
+                slide += `> ${citation}\n`;
+            });
+        }
+        return slide;
+    },
+};

package/build/layouts/figure.js

@@ -0,0 +1,62 @@
+/**
+ * Figure layout - content with background image
+ */
+export const figureLayout = {
+    name: "figure",
+    description: "Slide with background image and content overlay",
+    params: {
+        heading: {
+            type: "string",
+            description: "Slide heading (max 50 chars, displays as h2)",
+            required: false,
+            maxLength: 50,
+        },
+        content: {
+            type: "string",
+            description: "Content text (max 300 chars recommended, markdown supported)",
+            required: false,
+            maxLength: 500,
+        },
+        imagePath: {
+            type: "string",
+            description: "Image file path (local paths supported, e.g., ./attachments/image.png)",
+            required: true,
+        },
+        imagePosition: {
+            type: "string",
+            description: "Image position: 'right' or 'left' (default: 'right')",
+            required: false,
+        },
+        imageSize: {
+            type: "string",
+            description: "Image size: 'cover' or 'contain' (default: 'contain')",
+            required: false,
+        },
+        citations: {
+            type: "array",
+            description: "Citations/references (array of strings)",
+            required: false,
+        },
+    },
+    template: (params) => {
+        let slide = "";
+        if (params.heading) {
+            slide += `## ${params.heading}\n\n`;
+        }
+        if (params.content) {
+            slide += `${params.content}\n\n`;
+        }
+        // Build background image directive
+        const position = params.imagePosition || 'right';
+        const size = params.imageSize || 'contain';
+        slide += `![bg ${position} ${size}](${params.imagePath})`;
+        // Add citations
+        if (params.citations && params.citations.length > 0) {
+            slide += '\n\n';
+            params.citations.forEach((citation) => {
+                slide += `> ${citation}\n`;
+            });
+        }
+        return slide;
+    },
+};

package/build/layouts/image-center.js

@@ -0,0 +1,49 @@
+/**
+ * Image layout - centered image display
+ */
+export const imageLayout = {
+    name: "image-center",
+    description: "Slide with centered image (fixed h:350)",
+    params: {
+        heading: {
+            type: "string",
+            description: "Slide heading (max 40 chars, ~22 chars for Japanese)",
+            required: true,
+            maxLength: 40,
+        },
+        imagePath: {
+            type: "string",
+            description: "Image file path (local paths supported, e.g., ./attachments/image.png)",
+            required: true,
+        },
+        description: {
+            type: "string",
+            description: "Image description below image (max 55 chars, ~33 chars for Japanese)",
+            required: false,
+            maxLength: 55,
+        },
+        citations: {
+            type: "string",
+            description: "Citation (max 50 chars, ~30 chars for Japanese, no line break)",
+            required: false,
+            maxLength: 50,
+        },
+    },
+    template: (params) => {
+        let slide = "";
+        if (params.heading) {
+            slide += `## ${params.heading}\n\n`;
+        }
+        // Fixed image directive: center h:350
+        slide += `![center h:350](${params.imagePath})`;
+        // Image description (optional)
+        if (params.description) {
+            slide += `\n\n${params.description}`;
+        }
+        // Citation (single, no line break)
+        if (params.citations) {
+            slide += `\n\n> ${params.citations}`;
+        }
+        return slide;
+    },
+};

package/build/layouts/image-right.js

@@ -0,0 +1,50 @@
+/**
+ * Image-right layout - content list with background image on right
+ */
+export const imageRightLayout = {
+    name: "image-right",
+    description: "Slide with image on right and content list (allows more explanation than image-center)",
+    params: {
+        heading: {
+            type: "string",
+            description: "Slide heading (max 17 chars, ~10 chars for Japanese)",
+            required: true,
+            maxLength: 17,
+        },
+        list: {
+            type: "array",
+            description: "List items (max 8 items, each max 23 chars, ~14 chars for Japanese)",
+            required: true,
+            maxItems: 8,
+            maxLength: 23,
+        },
+        imagePath: {
+            type: "string",
+            description: "Image file path (local paths supported, e.g., ./attachments/image.png)",
+            required: true,
+        },
+        citations: {
+            type: "string",
+            description: "Citation (max 50 chars, ~30 chars for Japanese, no line break)",
+            required: false,
+            maxLength: 50,
+        },
+    },
+    template: (params) => {
+        let slide = "";
+        if (params.heading) {
+            slide += `## ${params.heading}\n\n`;
+        }
+        // List items
+        params.list.forEach((item) => {
+            slide += `- ${item}\n`;
+        });
+        // Fixed background image: bg right:50% contain
+        slide += `\n![bg right:50% contain](${params.imagePath})`;
+        // Citation (single, no line break)
+        if (params.citations) {
+            slide += `\n\n> ${params.citations}`;
+        }
+        return slide;
+    },
+};

package/build/layouts/image.js

@@ -0,0 +1,59 @@
+/**
+ * Image layout - centered image display
+ */
+export const imageLayout = {
+    name: "image",
+    description: "Slide with centered image",
+    params: {
+        heading: {
+            type: "string",
+            description: "Slide heading (max 50 chars, displays as h2)",
+            required: false,
+            maxLength: 50,
+        },
+        imagePath: {
+            type: "string",
+            description: "Image file path (local paths supported, e.g., ./attachments/image.png)",
+            required: true,
+        },
+        height: {
+            type: "number",
+            description: "Image height in pixels (e.g., 330)",
+            required: false,
+        },
+        width: {
+            type: "string",
+            description: "Image width (e.g., '80%', '500px')",
+            required: false,
+        },
+        citations: {
+            type: "array",
+            description: "Citations/references (array of strings)",
+            required: false,
+        },
+    },
+    template: (params) => {
+        let slide = "";
+        if (params.heading) {
+            slide += `## ${params.heading}\n\n`;
+        }
+        // Build image directive
+        let imageDirective = "![center";
+        if (params.height) {
+            imageDirective += ` h:${params.height}`;
+        }
+        if (params.width) {
+            imageDirective += ` w:${params.width}`;
+        }
+        imageDirective += `](${params.imagePath})`;
+        slide += imageDirective;
+        // Add citations
+        if (params.citations && params.citations.length > 0) {
+            slide += '\n\n';
+            params.citations.forEach((citation) => {
+                slide += `> ${citation}\n`;
+            });
+        }
+        return slide;
+    },
+};