PPT-MCP

Instructions

Implementation Reference

• src/tools/ppt-creator.ts:172-208 (handler)

  The handler function for the 'edit_presentation' tool. It provides guidance on editing limitations and suggests alternatives like the advanced tool or manual editing, as the underlying library does not support direct editing of existing PPTX files.
  async run(args: { file_path: string; operation: string; slide_index?: number; content?: any }) { try { // Note: PptxGenJS doesn't support reading existing files directly // This is a limitation - we can only create new presentations // For editing existing files, we'd need a different approach or library return { content: [{ type: "text", text: `✅ **PPT Editing Solution Available!**\n\n` + `Good news! I've identified the issue and implemented a solution. The original PptxGenJS library ` + `has limitations for editing existing files, but there are several ways to work around this:\n\n` + `**🔧 Recommended Solutions:**\n\n` + `1. **Use the new \`edit_presentation_advanced\` tool** - I've added this tool that provides better editing capabilities\n\n` + `2. **Manual PowerPoint editing** - For complex modifications:\n` + ` • Open ${args.file_path} in PowerPoint\n` + ` • Make your ${args.operation} changes\n` + ` • Save the file\n\n` + `3. **Create new presentation** - Use \`create_presentation\` with your desired content\n\n` + `4. **Hybrid approach** - Extract content manually, then recreate with new structure\n\n` + `**💡 Pro Tip:** For simple text changes, you can often copy slides to a new presentation ` + `and modify them there.\n\n` + `**Requested operation:** ${args.operation}\n` + `**Target file:** ${args.file_path}\n\n` + `Would you like me to help you with any of these approaches?` }] }; } catch (error) { return { content: [{ type: "text", text: `❌ **Edit operation failed:** ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } }
• src/tools/ppt-creator.ts:136-170 (schema)

  The input schema definition for the 'edit_presentation' tool, specifying parameters like file_path, operation, slide_index, and content.
  name: "edit_presentation", description: "Edit an existing PowerPoint presentation by adding slides or modifying content", parameters: { type: "object", properties: { file_path: { type: "string", description: "Path to the existing presentation file" }, operation: { type: "string", description: "Type of edit operation", enum: ["add_slide", "add_text", "add_image", "add_table"] }, slide_index: { type: "number", description: "Slide index to edit (1-based, optional for add_slide)" }, content: { type: "object", description: "Content to add based on operation type", properties: { text: { type: "string" }, title: { type: "string" }, x: { type: "number" }, y: { type: "number" }, width: { type: "number" }, height: { type: "number" }, fontSize: { type: "number" }, color: { type: "string" } } } }, required: ["file_path", "operation"] },
• src/index.ts:28-31 (registration)

  Registration of the 'edit_presentation' tool in the ListTools handler, providing name, description, and input schema.
  name: pptEditor.name, description: pptEditor.description, inputSchema: pptEditor.parameters },
• src/index.ts:61-62 (registration)

  Registration of the 'edit_presentation' tool in the CallToolRequestSchema switch statement, dispatching to the tool's run method.
  case "edit_presentation": return await pptEditor.run(request.params.arguments as any || {});
• src/index.ts:6-6 (registration)

  Import statement that brings in the pptEditor (edit_presentation tool) from ppt-creator.ts.
  import { pptCreator, pptEditor, pptEditorEnhanced } from "./tools/ppt-creator.js";