PPTX发生器MCP服务器
模型上下文协议（MCP）服务器，用于从Markdown生成专业PowerPoint演示文稿。
将您的课程计划和文档转化为精美的PPTX演示文稿，支持：
- ✅ 内联代码 采用单空间格式
- ✅ 代码块 带有语法高亮背景
- ✅ 表格 带有样式化的标题
- ✅ 粗体 以及混合格式
- ✅ 项目符号列表 有适当的压痕
- ✅ 混合内容 幻灯片（项目符号+代码+表格）
- ✅ 定制品牌 （徽标、颜色、讲师信息）
______________________________________________________________________
📋 目录
- 方法1：快速安装（推荐） - 方法2：手动安装
- Claude桌面设置 - 定制
- 在克劳德桌面 - Markdown格式
______________________________________________________________________
🔧 需求
检查你的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-mcp2.运行安装脚本：
./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 install2.全局安装：
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
}
}字体大小
{
"sizes": {
"slideTitle": 28,
"body": 18,
"code": 14
}
}编辑config.json后：
- 无需重新启动Claude Desktop
- 更改将应用于下一个生成的演示文稿
______________________________________________________________________
🎯 用法
在克劳德桌面
安装和配置后，您可以在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:docker ps docker images
表：
|第1列|第2列|
|----------|----------|
| `value1` |说明1|
| `value2` |说明2|
Formatting
- Bold text:
**text** - Inline code: `
- Code blocks: Triple backticks with optional language
- Tables: Standard Markdown table syntax
- Bullets:
-or*with optional indentation
📚 Examples
Simple Presentation
---
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:print("Hello, World!")
Advanced Features
## [content] Docker Commands
Common commands:
| Command | Description |
|---------|-------------|
| `docker ps` | List running containers |
| `docker images` | List images |
| `docker run` | Run a container |
Example usage:docker run -d -p 80:80 nginx
这 `-d` 旗帜飘扬 **分离模式**.
🐛 Troubleshooting
Command not found: pptx-generator-mcp
Solution 1: Check if installed globally
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教育