给 Claude Code 和 Codex 装上文档 PPT超能力MCP 插件接入实战附踩坑记录前言日常写技术文档、做汇报 PPT 是最消耗时间的工作之一。如果能直接对 AI 编程助手说一句帮我写一份带目录、排好版的 Word 报告“做一个 10 页的产品介绍 PPT”它会自己完成构思、排版、润色那效率会提升一大截。最近我给自己本地的Claude Code和Codex CLI做了一次能力强化让它们具备了✅ 独立写 Word 文档排版、表格、页眉页脚、目录、导出 PDF✅ 制作可编辑的 .pptx 演示文稿无需安装 Office✅ 中文写作润色去 AI 味、公众号长文、降 AIGC本文完整记录整个接入过程包括选型、部署命令、以及两个翻车方案的踩坑实录希望能帮你少走弯路。一、方案选型核心思路通过MCPModel Context Protocol给 AI 接入工具让模型能真正操作文件、生成 Office 文档再通过Claude Code 插件Plugin/Skill注入写作方法论。能力方案说明Word 排版office-mcpPython 实现60 操作字体、样式、表格、页眉页脚、目录、PDF 导出Word/Excel/PPT 一体Word 精细操作SKILLful-mcp-docx-processor63 个操作覆盖文档创建、编辑、格式化全生命周期PPT 制作office-mcp 的 PPT 模块基于 python-pptx无需本机安装 Office写作润色writing-zh 插件humanizer-zh去 AI 味、khazix-writer公众号长文等 4 个技能⚠️ 选型提醒网上很多PPT MCP依赖COM 自动化操控真实 PowerPoint如 powerpoint-mcp、ppt-mcp如果电脑没装微软 Office 或 WPS这类方案全部不可用。纯代码生成 .pptx的方案才不依赖 Office。二、环境准备我的环境Windows 11组件版本Node.jsv22.14.0自带 npm 10.9.2Python3.13.9推荐使用AnacondaClaude Code2.1.220已安装Git2.55.0安装 Codex CLInpminstall-gopenai/codex codex--version# 验证安装安装完成后首次使用前需要认证codex login浏览器登录。国内网络提示npm 安装一般没问题但pip 直连 PyPI 容易超时建议全程加镜像源pip install xxx -i https://pypi.tuna.tsinghua.edu.cn/simple三、接入文档类 MCP统一把插件源码放到C:\Users\Administrator\mcp-servers\下管理。1. 克隆仓库mkdir-p~/mcp-serverscd~/mcp-serversgitclone--depth1https://github.com/walkingzzzy/office-mcp.gitgitclone--depth1https://github.com/Zeke-777/SKILLful-mcp-docx-processor.git2. 安装依赖关键技巧两个项目都是 Python 写的各自创建独立虚拟环境。我的电脑装的是 Anaconda自带 numpy/pandas/scipy/sklearn 等重库所以用--system-site-packages复用它们只补装轻量依赖速度飞快# office-mcp入口python -m office_mcp_server.maincd~/mcp-servers/office-mcp python-mvenv --system-site-packages venv ./venv/Scripts/python.exe-mpipinstall-ihttps://pypi.tuna.tsinghua.edu.cn/simple\fastmcp python-docx openpyxl python-pptx reportlab Pillow python-dotenv pydantic loguru# docx-processor入口python server.pycd~/mcp-servers/SKILLful-mcp-docx-processor python-mvenv --system-site-packages venv ./venv/Scripts/python.exe-mpipinstall-ihttps://pypi.tuna.tsinghua.edu.cn/simple\mcp1.0.0,2.0.0python-docx~1.1.0lxml5.0.03. 注册到 Claude Code# office-mcp模块化入口需要 PYTHONPATH 指向 srcclaude mcpadd--scopeuser office-mcp\-ePYTHONPATHC:/Users/Administrator/mcp-servers/office-mcp/src\-- C:/Users/Administrator/mcp-servers/office-mcp/venv/Scripts/python.exe-moffice_mcp_server.main# docx-processor脚本入口直接指定路径claude mcpadd--scopeuser docx-processor\-- C:/Users/Administrator/mcp-servers/SKILLful-mcp-docx-processor/venv/Scripts/python.exe\C:/Users/Administrator/mcp-servers/SKILLful-mcp-docx-processor/server.py--scope user表示对所有项目生效写入~/.claude.json之后用claude mcp list查看连接状态。4. 注册到 CodexCodex CLI 的 MCP 配置在~/.codex/config.toml的[mcp_servers]段注意Codex 只认 config.toml不认 config.json我一开始被第三方安装器坑过[mcp_servers.office-mcp] command C:\Users\Administrator\mcp-servers\office-mcp\venv\Scripts\python.exe args [-m, office_mcp_server.main] [mcp_servers.office-mcp.env] PYTHONPATH C:\Users\Administrator\mcp-servers\office-mcp\src [mcp_servers.docx-processor] command C:\Users\Administrator\mcp-servers\SKILLful-mcp-docx-processor\venv\Scripts\python.exe args [C:\Users\Administrator\mcp-servers\SKILLful-mcp-docx-processor\server.py]用codex mcp list验证显示enabled即注册成功。5. 把 docx 处理 skill 装给 Codexmkdir-p~/.codex/skillscp-r~/mcp-servers/SKILLful-mcp-docx-processor/skills/docx-process ~/.codex/skills/四、接入写作润色插件 writing-zhClaude Code 插件市场的标准安装方式是claude plugin marketplaceaddhttps://github.com/SummerSec/SumSec-Skills.git claude plugininstallwriting-zhsumsec-skills但GitHub 直连不稳定marketplace add直接卡死超时。解决办法先下载 tarball 解压到本地再用本地路径注册市场# 1. 下载整仓 tarball单连接 断点续传比 git 多连接稳cd~/mcp-serverscurl-L--retry4--retry-all-errors-C--osumsec.tar.gz\https://codeload.github.com/SummerSec/SumSec-Skills/tar.gz/refs/heads/mastertar-xzfsumsec.tar.gzmvSumSec-Skills-master SumSec-Skills# 2. 本地注册市场 安装插件claude plugin marketplaceaddC:/Users/Administrator/mcp-servers/SumSec-Skillsclaude plugininstallwriting-zhsumsec-skills claude plugin list# 确认 writing-zh 为 enabled安装后可获得 4 个写作技能humanizer-zh去 AI 味润色、khazix-writer公众号长文、creating-blog-web-pptMarkdown 转网页 PPT、sumsec-illustrations正文配图。五、踩坑记录重点坑 1paperjsx —— 需要付费许可证网上很火的 paperjsxJSON 生成 PPTX/DOCX/XLSX/PDF号称免费无 Key实际上它的MCP 服务器启动时就强制校验许可证无PAPERJSX_LICENSE_KEY直接崩溃退出[PaperJSXFeatureError]: PPTX rendering requires a valid PaperJSX Pro license key. Set PAPERJSX_LICENSE_KEY or create the engine with a licenseKey. code: LICENSE_REQUIRED免费只是底层渲染库免费服务器本身是收费的。果断移除改用 office-mcp 的 PPT 模块。坑 2presentation-md —— 上游 npm 包缺失presentation-mdDeck JSON 转原生 PPTX/PDF设计质量很高但最新版1.31.1 / 1.32.0 均复现启动即崩溃Error [ERR_MODULE_NOT_FOUND]: Cannot find module ...presentation-md/shared/theme-surfaces.json imported from ...presentation-md/core/dist/theme-surface.js查证后确认presentation-md/core引用了从未发布到 npm 的presentation-md/shared包npm 上 404属于上游发布事故只能等修复。它的官方安装器claude-code 适配器还有 PowerShell 语法错误双保险都不靠谱。坑 3GitHub 直连不稳定克隆大仓库频繁curl 28 Could not connect to server断连claude plugin marketplace add远程克隆直接卡死超时。解决方案按优先级# 浅克隆最常用gitclone--depth1repo-url# 更轻量只拉取需要的子目录gitclone--depth1--filterblob:none--sparserepo-urlgitsparse-checkoutsetwriting-zh# 终极方案codeload 单连接下载 tarball带断点续传curl-L--retry4--retry-all-errors-C--orepo.tar.gz\https://codeload.github.com/owner/repo/tar.gz/refs/heads/master坑 4CC Switch 会覆盖 Codex 配置如果你用 CC Switch 管理 Claude/Codex 的供应商配置注意切换供应商时它会重写~/.codex/config.toml旧版本会把你自己配的[mcp_servers]全部抹掉GitHub issue #1088 就是投诉这个。已知情况v3.12.2 起已修复切换时保留已有 mcp_serversSection-Aware TOML 编辑Claude 端不受影响Claude 的 MCP 在~/.claude.jsonCC Switch 只写~/.claude/settings.json最稳妥的做法把 MCP 服务器导入 CC Switch 的MCP 管理面板由它统一持久化切换供应商后自动重写永不丢失。六、使用演示在 Claude Code / Codex 会话里直接用自然语言即可# 生成 Word 报告自动排版标题、表格、目录 帮我用 office-mcp 生成一份《项目周报.docx》包含本周数据表格和目录 # 精细排版 用 docx-processor 把这份文档排一下版一级标题居中、二级标题加粗、重点内容标红 # 制作 PPT 用 office-mcp 做一个 12 页的《产品介绍.pptx》每页大标题 3 个要点 # 写作润色触发 writing-zh 把上面这段文字润色一下去掉 AI 味读起来像人写的验证命令claude mcp list# MCP 连接状态✔ Connected 为正常codex mcp list# Codex 侧 MCPclaude plugin list# 插件状态七、总结纯代码生成方案office-mcp docx-processor不依赖本机安装 Office最适合没装 Office 也能产出可编辑文档/PPT的场景写作能力靠插件注入writing-zh 这类 Claude Code 插件把写作方法论教给模型润色效果立竿见影网上热门的两个 PPT 方案paperjsx / presentation-md目前都不可用一个要付费许可证一个是上游发布事故选型时务必先验证启动配置类工具CC Switch和 MCP 共存时先摸清它管理哪些文件避免切换供应商把配置冲掉。希望这份实战记录能帮你一次接入成功。如果你也在用 MCP 做文档/PPT 自动化欢迎评论区交流你的方案本文为实际操作记录环境Windows 11 Claude Code 2.1.220 Codex CLI 0.146.0