This release is a pre-release and may not be stable for production use.
WPS MCP
🪄 让 AI 接管 WPS Office,自主编辑文档、处理表格和制作演示文稿
45 个工具组 · 252 项操作 · WPS 文字 / 表格 / 演示
WPS MCP 为 AI 助手提供 Word 文档编辑、Excel 表格处理、PowerPoint(PPT)制作及 PDF 导出与预览能力,基于 WPS Office 运行,支持 Windows、Linux 和 macOS。
* 上方视频可能因网络原因无法加载或播放。
功能与平台对比
| 组件 | 功能 | Windows | Linux | macOS |
|---|---|---|---|---|
| 通用 | 环境检测、组件连接与启动 | ✅ | ✅ | ✅ |
| 文档新建、模板与打开 | ✅ | ✅ | ✅ | |
| 文档保存、另存为与关闭 | ✅ | ✅ | ✅ | |
| 文档信息读取 | ✅ | ✅ | ✅ | |
| PDF 导出与页面预览 | ✅ | ✅ | ✅ | |
| 接管用户已打开的 WPS 窗口 | ✅ | ❌ | ✅ | |
| WPS 文字 | 正文读写与查找替换 | ✅ | ✅ | ✅ |
| 字体、段落与样式管理 | ✅ | ✅ | ✅ | |
| 表格与图片 | ✅ | ✅ | ✅ | |
| 页面、分节与页眉页脚 | ✅ | ✅ | ✅ | |
| 修订跟踪、批注与文档统计 | ✅ | ✅ | ✅ | |
| 书签与目录 | ✅ | ✅ | ✅ | |
| 脚注、尾注与交叉引用 | ✅ | ✅ | ✅ | |
| 本地 CSV 邮件合并 | ✅ | ✅ | ✅ | |
| WPS 表格 | 工作表管理 | ✅ | ✅ | ✅ |
| 单元格读写、公式与重算 | ✅ | ✅ | ✅ | |
| 单元格格式、行列调整、合并与冻结 | ✅ | ✅ | ✅ | |
| 命名区域 | ✅ | ✅ | ✅ | |
| 查找、排序与筛选 | ✅ | ✅ | ✅ | |
| 结构化表格 | ✅ | ✅ | ✅ | |
| 图表与图表数据源更新 | ✅ | ✅ | ✅ | |
| 数据透视表 | ✅ | ✅ | ✅ | |
| 条件格式新增、读取与删除 | ✅ | ✅ | ✅ | |
| 条件格式修改 | ✅ | ✅ | 部分¹ | |
| 数据验证与下拉列表 | ✅ | ✅ | ✅ | |
| WPS 演示 | 文稿、模板与属性标签 | ✅ | ✅ | ✅ |
| 幻灯片、分节与备注 | ✅ | ✅ | ✅ | |
| 主题应用 | ✅ | ✅ | ✅ | |
| 母版、版式与占位符 | ✅ | ✅ | ✅ | |
| 读取标题母版状态 | ✅ | ✅ | ❌ | |
| 主题配色修改 | ✅ | ✅ | 部分² | |
| 幻灯片背景 | ✅ | ✅ | ✅ | |
| 文字与字体排版 | ✅ | ✅ | ✅ | |
| Markdown 提取、排版检查与修复 | ✅ | ✅ | ✅ | |
| 形状、图层与样式 | ✅ | ✅ | ✅ | |
| 连接线:按数字连接点索引连接 | ✅ | ✅ | ✅ | |
| 连接线:按方向选择连接点 | ✅ | ✅ | ❌ | |
| 自由形状:直线段与闭合路径 | ✅ | ✅ | ✅ | |
| 自由形状:贝塞尔曲线 | ✅ | ✅ | ❌ | |
| 自由形状:节点读取与编辑 | ✅ | ✅ | ❌ | |
| SmartArt 创建、布局、颜色与样式 | ✅ | ✅ | ✅ | |
| SmartArt 节点文字、增删与格式 | ✅ | ✅ | ❌ | |
| 本地图片插入与裁剪 | ✅ | ✅ | ✅ | |
| 读取图片透明色 | ✅ | ✅ | ❌ | |
| 网络图片与图标 | ✅³ | ✅³ | ✅³ | |
| 音视频插入与播放设置 | ✅ | ✅ | ✅ | |
| 音视频裁剪 | ✅⁴ | ✅⁴ | ✅⁴ | |
| 表格编辑 | ✅ | ✅ | ✅ | |
| 图表创建、类型与格式 | ✅⁵ | ✅⁵ | ✅⁵ | |
| 图表数据读取 | ✅ | ✅⁶ | 部分⁶ | |
| 图表数据修改 | 部分⁷ | ❌ | ❌ | |
| 对象动画添加、修改与删除 | ✅ | ✅ | ✅ | |
| 动画信息读取 | ✅ | ✅ | 部分⁸ | |
| 幻灯片切换效果 | ✅ | ✅ | ✅ | |
| 批注、超链接与窗口视图 | ✅ | ✅ | ✅ | |
| 放映控制 | ✅ | ✅ | ❌ | |
| 撤销、重做与批量操作撤销分组 | ✅ | ✅ | ✅ | |
| 幻灯片图片与形状导出 | ✅ | ✅ | ✅ | |
| 复制图片到剪贴板 | ✅ | ✅⁹ | ✅ |
- 实际可用性以当前 WPS 版本为准。
- ¹ macOS:替换规则时保留可读颜色,无法保留不可读取的主题绑定
- ² macOS:颜色方案名称会变为
WPS MCP,未指定的颜色保留 - ³ 需要联网。
- ⁴ 需要当前 WPS 提供裁剪接口
- ⁵ 含可编辑图表请保存为
.pptx - ⁶ Linux:可能打开图表数据编辑器;macOS:读取缓存数值,系列名称返回
null,新图表分类标签可能为空 - ⁷ Windows:需保持现有分类数和系列数,数据源位于首张工作表,第一行为标题、A 列为分类、B 列起为系列数值
- ⁸ macOS:方向信息返回
null,其他已支持的信息不受影响 - ⁹ Linux:X11 需
xclip,Wayland 需wl-copy
快速开始
1. 准备环境
先安装 WPS Office 和 uv,再配置 MCP 客户端。
| 平台 | Python | WPS 与桌面环境 | 会话方式 |
|---|---|---|---|
| Windows | 3.11+ | WPS 已注册 COM 接口 | 可连接已有实例,或按需启动 |
| Linux x86_64 | CPython 3.11 | WPS Linux、Qt5、已登录的 X11 或带 XWayland 的桌面 | 使用 MCP 管理的实例,不接管已有桌面窗口 |
| macOS | 3.11+ | WPS 桌面版,安装包包含内置自动化驱动 | 连接本机 WPS,首次连接可启动编辑器 |
2. 配置 MCP 客户端
MCP 配置
Windows / macOS:
{
"mcpServers": {
"wps": {
"command": "uvx",
"args": ["wps-mcp@latest"]
}
}
}
Linux 必须指定 CPython 3.11:
{
"mcpServers": {
"wps": {
"command": "uvx",
"args": ["--no-config", "--python", "3.11", "wps-mcp@latest"]
}
}
}
使用预发布版本时,将对应配置中的 args 替换为:
# Windows / macOS
"args": ["--prerelease", "allow", "wps-mcp@latest"]
# Linux
"args": ["--no-config", "--python", "3.11", "--prerelease", "allow", "wps-mcp@latest"]
环境配置与故障排查
可选环境变量
通常无需配置。需要指定安装位置、模板或 WPS 实例时,只填写需要的变量,路径使用绝对路径。
| 变量 | 何时设置 |
|---|---|
WPS_OFFICE_DIR |
Linux 找不到 WPS 时,填写包含 wps、et、wpp 的 office6 目录。 |
WPS_TEMPLATES_DIR |
使用自己的模板时,填写模板目录。 |
WPS_DRIVER_DIR |
macOS 驱动目录不同于默认的 ~/Library/Containers/com.kingsoft.wpsoffice.mac/Data 时,填写实际目录。 |
WPS_DRIVER_SOCKET |
macOS 需要指定 WPS 实例时,填写检测结果中的 socket 路径,见上方示例。 |
例如,Linux 指定 WPS 安装目录和模板目录(请替换为本机实际路径):
{
"mcpServers": {
"wps": {
"command": "uvx",
"args": ["--no-config", "--python", "3.11", "wps-mcp@latest"],
"env": {
"WPS_OFFICE_DIR": "/opt/kingsoft/wps-office/office6",
"WPS_TEMPLATES_DIR": "/home/user/wps-templates"
}
}
}
}
已有 env 时,将需要的变量合并到同一个 env 中。
Linux 桌面环境配置与常见报错
从已登录的图形桌面启动 MCP 客户端。若出现 Run in a desktop session with DISPLAY and X authority,在该桌面的终端查询环境变量:
env | grep -E '^(DISPLAY|XAUTHORITY|WAYLAND_DISPLAY|XDG_RUNTIME_DIR|DBUS_SESSION_BUS_ADDRESS)='
把查询结果填入下面的 env。值仅作示例,请替换为实际输出,未输出的项删掉:
{
"mcpServers": {
"wps": {
"command": "uvx",
"args": ["--no-config", "--python", "3.11", "wps-mcp@latest"],
"env": {
"DISPLAY": ":0",
"XAUTHORITY": "/home/user/.Xauthority",
"WAYLAND_DISPLAY": "wayland-0",
"XDG_RUNTIME_DIR": "/run/user/1000",
"DBUS_SESSION_BUS_ADDRESS": "unix:path=/run/user/1000/bus"
}
}
}
}
macOS 启动、权限与多实例
| 遇到的问题 | 处理方法 |
|---|---|
| 找不到编辑器 | 先用 WPS 打开一个文档,再重试连接。 |
| 无法访问文件 | 在 WPS 的“打开”对话框中选择目标文件或目录,授予访问权限。 |
| 检测到多个 WPS 进程 | 让 AI 调用 wps_components/detect,从返回的 editor_sockets 中选择目标路径,填入 WPS_DRIVER_SOCKET。 |
指定 WPS 实例的配置示例,将 socket 路径替换为检测结果中的实际路径:
{
"mcpServers": {
"wps": {
"command": "uvx",
"args": ["wps-mcp@latest"],
"env": {
"WPS_DRIVER_SOCKET": "/Users/user/Library/Containers/com.kingsoft.wpsoffice.mac/Data/wpsdriverlocal_wps_12345"
}
}
}
}
同一 WPS 实例请避免同时连接多个 MCP 服务。
本地开发
使用本地源码
下载或克隆项目,在根目录安装依赖:# Windows / macOS
uv sync --locked
# Linux
uv sync --locked --python 3.11
将下面的 项目目录 替换为项目根目录(包含 pyproject.toml 的目录),例如 d:/projects/wps-mcp 或 /home/user/projects/wps-mcp。
Windows / macOS:
{
"mcpServers": {
"wps": {
"command": "uv",
"args": ["--directory", "项目目录", "run", "wps-mcp"]
}
}
}
Linux:
{
"mcpServers": {
"wps": {
"command": "uv",
"args": ["--directory", "项目目录", "run", "--python", "3.11", "wps-mcp"]
}
}
}
论坛 · LINUX DO
Metadata
Release files for wps-mcp 2026.10.29.dev13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| wps_mcp-2026.10.29.dev13.tar.gz | 435.4 kB | With provenance | Details for wps_mcp-2026.10.29.dev13.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| wps_mcp-2026.10.29.dev13-py3-none-any.whl | Python 3 | none | any | Details for wps_mcp-2026.10.29.dev13-py3-none-any.whl |
Total release size: 712.7 kB
Release files / wps_mcp-2026.10.29.dev13.tar.gz
| Download URL | wps_mcp-2026.10.29.dev13.tar.gz |
|---|---|
| Size | 435.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2859144a9e401160037ce3bb7c69766748c1fe6c7f00a77889c1ecf7bdad0ed8
|
|
BLAKE2b-256 checksum How to use checksums |
ae179ea0ad3c1f7ef32f8b3d15fcc40f997f65b6055ad8092788fa24b2fa7e7a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.
Transparency logRelease files / wps_mcp-2026.10.29.dev13-py3-none-any.whl
| Download URL | wps_mcp-2026.10.29.dev13-py3-none-any.whl |
|---|---|
| Size | 277.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ac1e5d825fef2d6da3d689b6482ca88eca92a55dae7048a67ff9955a0778b71c
|
|
BLAKE2b-256 checksum How to use checksums |
13492460dd578bb9d5bc8b8a11c99b34b9700f3f52ce612f42a4e63363dceea1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.
Transparency logSecurity for wps-mcp 2026.10.29.dev13
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for wps_mcp-2026.10.29.dev13.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.