使用说明

PPTX发生器MCP服务器

模型上下文协议（MCP）服务器，用于从Markdown生成专业PowerPoint演示文稿。

将您的课程计划和文档转化为精美的PPTX演示文稿，支持：

✅ 内联代码 采用单空间格式
✅ 代码块 带有语法高亮背景
✅ 表格带有样式化的标题
✅ 粗体以及混合格式
✅ 项目符号列表 有适当的压痕
✅ 混合内容 幻灯片（项目符号+代码+表格）
✅ 定制品牌 （徽标、颜色、讲师信息）

📋 目录

需求
安装
- 方法1：快速安装（推荐）
- 方法2：手动安装
配置
- Claude桌面设置
- 定制
用法
- 在克劳德桌面
- Markdown格式
例子
故障排除
更新中
卸载

🔧 需求

Node.js 18.0或更高(下载)
克劳德桌面版 (下载)
macOS、Linux或Windows

检查你的Node.js版本：

node -v

📦 安装

方法1：快速安装（推荐）

1.克隆存储库：

cd ~/Documents  # or any directory you prefer
git clone https://github.com/dmytro-ustynov/pptx-generator-mcp.git
cd pptx-generator-mcp

2.运行安装脚本：

./install.sh

脚本将：

安装所有依赖项
全局安装该命令
显示Claude Desktop配置

3.配置克劳德桌面：

安装程序将显示要添加的内容。将配置复制到：

macOS/Linux： ~/Library/Application Support/Claude/claude_desktop_config.json
窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pptx-generator": {
      "command": "pptx-generator-mcp"
    }
  }
}

4.重新启动克劳德桌面

✅ 完成！这 pptx-generator 工具现在可以在Claude中使用。

方法2：手动安装

1.克隆和安装依赖关系：

# Change dmytro-ustynov to your username if you want to use your fork
git clone https://github.com/dmytro-ustynov/pptx-generator-mcp.git 
cd pptx-generator-mcp
npm install

2.全局安装：

npm install -g .

如果需要，可以使用sudo：

sudo npm install -g .

3.验证安装：

which pptx-generator-mcp
# Should show: /usr/local/bin/pptx-generator-mcp (or similar)

4.配置克劳德桌面 （与方法1步骤3相同）

⚙️ 配置

Claude桌面设置

安装后，配置Claude Desktop以使用MCP服务器。

macOS/Linux：

# Open the config file
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
# or
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

窗户：

notepad %APPDATA%\Claude\claude_desktop_config.json

添加此配置：

{
  "mcpServers": {
    "pptx-generator": {
      "command": "pptx-generator-mcp"
    }
  }
}

如果您有其他MCP服务器：

{
  "mcpServers": {
    "pptx-generator": {
      "command": "pptx-generator-mcp"
    },
    "other-server": {
      "command": "other-server-command"
    }
  }
}

重新启动克劳德桌面 以使更改生效。

定制

通过编辑自定义颜色、字体和品牌 config.json 在安装目录中。

查找您的安装：

npm list -g pptx-generator-mcp
# Shows: /usr/local/lib/node_modules/pptx-generator-mcp

编辑配置：

cd $(npm root -g)/pptx-generator-mcp
nano config.json

配置选项：

教师资讯

{
  "instructor": {
    "rank": "майор",
    "name": "Дмитро УСТИНОВ",
    "position": "викладач"
  }
}

机构详细信息

{
  "institution": {
    "name": [
      "Військовий інститут",
      "телекомунікацій та інформатизації",
      "імені Героїв Крут"
    ],
    "department": "кафедри Комп'ютерних наук та інтелектуальних технологій"
  }
}

颜色

颜色根据乌克兰官方武装部队进行调整品牌手册，标志为乌克兰武装部队徽章。

{
  "colors": {
    "step": "#6A653A",        // Dividers and table headers
    "titleText": "#003366",   // Slide titles
    "bodyText": "#333333"     // Regular text
  }
}

字体

{
  "fonts": {
    "title": "Raleway",
    "body": "Open Sans",
    "code": "JetBrains Mono"  // For inline code and code blocks
  }
}

🎯 用法

在克劳德桌面

安装和配置后，您可以在Claude中使用这些工具：

1.生成演示文稿：

Create a presentation about Docker basics with 5 slides

克劳德将使用 pptx-generator:generate_presentation 工具自动。

2.获取模板：

Show me the markdown template for presentations

用途 pptx-generator:get_template 工具。

3.查看配置：

What are the current presentation settings?

用途 pptx-generator:get_config 工具。

4.更新讲师：

Change the instructor to "капітан Іван ПЕТРЕНКО"

用途 pptx-generator:update_instructor 工具。

Markdown格式

演示文稿是用Markdown创建的，具有特殊的语法：

领班（必填）

---
discipline: Веб-розробка
type: practical
module: "3: Docker та контейнеризація"
lesson: "3.1: Основи Docker"
---

类型：

practical - 实践课程
lecture - 讲座课程
group - 团体课程

幻灯片类型

平面图幻灯片：

## [plan] План заняття

- Topic 1
- Topic 2
- Topic 3

分隔器滑块：

## [divider] 🔹 ЧАСТИНА 1. Introduction

内容幻灯片：

## [content] Slide Title

Regular text with **bold** and `inline code`.

Bullet points:
- First point with **bold**
- Second point with `code`
- Third point with **bold** and `code` mixed

Code block:
```bash
docker ps
docker images

表：

第1列	第2列
`value1`	说明1
`value2`	说明2


#### Formatting

- **Bold text:** `**text**`
- **Inline code:** `` `code` ``
- **Code blocks:** Triple backticks with optional language
- **Tables:** Standard Markdown table syntax
- **Bullets:** `-` or `*` with optional indentation

---

## 📚 Examples

### Simple Presentation

```markdown
---
discipline: Programming Basics
type: lecture
module: "1: Introduction"
lesson: "1.1: Hello World"
---

## [plan] План заняття

- What is programming
- First program
- Variables and types

## [divider] 🔹 Getting Started

## [content] What is Programming?

**Programming** is giving instructions to computers.

Key concepts:
- Variables store data
- Functions perform actions
- Loops repeat tasks

Example:
```python
print("Hello, World!")


### Advanced Features

```markdown
## [content] Docker Commands

Common commands:

| Command | Description |
|---------|-------------|
| `docker ps` | List running containers |
| `docker images` | List images |
| `docker run` | Run a container |

Example usage:
```bash
docker run -d -p 80:80 nginx

这 -d 旗帜飘扬 分离模式.


---

## 🐛 Troubleshooting

### Command not found: pptx-generator-mcp

**Solution 1:** Check if installed globally
```bash
npm list -g pptx-generator-mcp

解决方案2： 将npm全局bin添加到PATH

# Find npm global bin path
npm config get prefix

# Add to PATH (add to ~/.bashrc or ~/.zshrc)
export PATH=$(npm config get prefix)/bin:$PATH

解决方案3： 重新安装

cd /path/to/pptx-generator-mcp
npm install -g .

工具未在Claude中显示

检查Claude桌面配置：

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

验证JSON语法 （使用 Jsonlint)
完全重新启动克劳德桌面：
- 退出克劳德桌面（macOS上的Cmd+Q）
- 重新打开克劳德桌面
检查MCP服务器日志 （如果在Claude Desktop中可用）

安装时权限被拒绝

解决方案： 使用sudo

sudo npm install -g .

或者通过配置npm在不使用sudo的情况下安装：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

字体显示不正确

问题： JetBrains Mono等自定义字体未显示

解决方案： 在您的系统上安装字体：

下载 JetBrains单声道
安装字体
重新启动PowerPoint/Keynote

🔄 更新中

要更新到最新版本：

# Navigate to repository
cd /path/to/pptx-generator-mcp

# Pull latest changes
git pull

# Reinstall
npm install
npm install -g .

无需重新启动Claude Desktop -更改对新演示文稿立即生效。

🗑️ 卸载

# Uninstall global command
npm uninstall -g pptx-generator-mcp

# Remove repository
rm -rf /path/to/pptx-generator-mcp

# Remove from Claude Desktop config
# Edit: ~/Library/Application Support/Claude/claude_desktop_config.json
# Remove the "pptx-generator" section

📖 额外资源

MCP文件： https://modelcontextprotocol.io/
克劳德桌面： https://claude.ai/download
Markdown指南： https://www.markdownguide.org/

📝 许可证

MIT许可证-有关详细信息，请参阅许可证文件

🤝 贡献

欢迎投稿！拜托：

复刻仓库
创建要素分支
提交拉取请求

💬 支持

对于问题或疑问：

在GitHub上打开一个问题
检查故障排除章节

由...制作❤️ VITI教育

PPTX生成工具

使用说明

PPTX发生器MCP服务器

📋 目录

🔧 需求

📦 安装

方法1：快速安装（推荐）

方法2：手动安装

⚙️ 配置

Claude桌面设置

定制

教师资讯

机构详细信息

颜色

字体

字体大小

🎯 用法

在克劳德桌面

Markdown格式

领班（必填）

幻灯片类型

工具未在Claude中显示

安装时权限被拒绝

字体显示不正确

🔄 更新中

🗑️ 卸载

📖 额外资源

📝 许可证

🤝 贡献

💬 支持

使用说明

PPTX发生器MCP服务器

📋 目录

🔧 需求

📦 安装

方法1：快速安装（推荐）

方法2：手动安装

⚙️ 配置

Claude桌面设置

定制

教师资讯

机构详细信息

颜色

字体

字体大小

🎯 用法

在克劳德桌面

Markdown格式

领班（必填）

幻灯片类型

工具未在Claude中显示

安装时权限被拒绝

字体显示不正确

🔄 更新中

🗑️ 卸载

📖 额外资源

📝 许可证

🤝 贡献

💬 支持

相关 MCP

Markdown转换服务

PowerPoint操作服务器

网页抓取与渲染MCP服务

Markdown转思维导图服务

Markdown内容交付网络

网页内容解析器