项目简介

Chuk MCP PowerPoint Server是一个专业的PowerPoint设计系统,通过MCP协议为LLM客户端提供完整的PPT创建、编辑和管理功能。

主要功能

  • 模板驱动工作流:50+专业模板,每个模板包含多种布局
  • 通用组件API:单一工具支持所有组件类型(图表、表格、图像等)
  • 设计系统:基于shadcn/ui风格的组件架构,支持多种变体
  • 主题系统:15+内置主题,支持明暗模式切换
  • 组件注册表:LLM友好的组件发现和文档系统
  • 设计令牌:统一的颜色、排版、间距系统
  • 云存储支持:集成Tigris S3和Redis,支持生产环境部署
  • 智能占位符填充:自动内容处理和布局识别

安装步骤

# 使用uv包管理器
uv sync
uv run chuk-mcp-pptx

# 或使用pip
pip install -e .

服务器配置

在MCP客户端(如Claude Desktop)的配置文件中添加:

{
  "mcpServers": {
    "chuk-mcp-pptx": {
      "command": "uv",
      "args": ["run", "python", "-m", "chuk_mcp_pptx.server"]
}

基本使用方法

当通过MCP客户端连接后,可以使用以下工作流:

  1. 创建基于模板的演示文稿
await pptx_create(name="季度报告", template_name="品牌提案")
  1. 分析模板布局
await pptx_analyze_template("品牌提案")
  1. 添加并填充幻灯片
# 添加标题幻灯片
result = await pptx_add_slide_from_template(layout_index=0)
  1. 保存演示文稿
await pptx_save(path="季度报告.pptx")

核心工具类别

  • 演示文稿管理(创建、切换、删除)
  • 模板工作流(推荐使用)
  • 通用组件API
  • 布局管理
  • 主题工具
  • 检查分析工具
  • 语义工具(高级幻灯片创建)

信息

分类

桌面与硬件