WPS MCP

🪄 让 AI 接管 WPS，自动处理文档、表格与 PPT

45 个工具组 · 261 项操作 · 文字 / 表格 / 演示

https://github.com/user-attachments/assets/59574cdb-c623-48a9-850d-c4488c5acacc

功能与平台对比

支持两大平台三大办公组件

组件	功能	Windows	Linux
通用	环境检测、组件连接与启动	✅	✅
	文档新建、模板、打开、保存、另存为与关闭	✅	✅
	文档信息、PDF 导出与页面预览	✅	✅
	接管用户已打开的 WPS 窗口	✅	❌
WPS 文字	正文读写、查找替换、字体段落与样式管理	✅	✅
	表格、图片、页面分节与页眉页脚	✅	✅
	修订跟踪、批注与文档统计	✅	✅
	书签、目录、脚注尾注与交叉引用	✅	✅
	本地 CSV 邮件合并	✅	✅
WPS 表格	工作表管理、单元格读写、公式与重算	✅	✅
	单元格格式、行列调整、合并、冻结与命名区域	✅	✅
	查找、排序、筛选与结构化表格	✅	✅
	图表、图表数据源更新与数据透视表	✅	✅
	条件格式、数据验证与下拉列表	✅	✅
WPS 演示	文稿、模板、属性标签、幻灯片、分节与备注	✅	✅
	主题、母版、版式、占位符、背景与配色	✅	✅
	文字与字体排版、Markdown 提取、排版检查与修复	✅	✅
	形状、图层、样式、连接线、自由曲线与 SmartArt	✅	✅
	图片裁剪、网络图片与图标、音视频与播放设置	✅¹	✅¹
	表格编辑、图表创建、数据读取与图表格式	✅	✅
	修改图表数据	✅²	❌
	对象动画与幻灯片切换	✅	✅
	批注、超链接、窗口视图与放映控制	✅	✅
	撤销、重做与批量操作撤销分组	✅	✅
	PDF、幻灯片图片、形状导出与预览	✅	✅
	复制图片到剪贴板	✅	✅³

高级功能的可用性取决于 WPS 版本。
¹ 网络素材与媒体：网络图片与图标需要联网；媒体裁剪需要当前 WPS 提供对应接口。
² 演示图表：Windows 写入需保持现有分类数、系列数及首工作表标准列布局。Linux 支持创建和读取，可能打开数据编辑器。含可编辑图表请保存为 .pptx。
³ Linux 剪贴板：X11 需 xclip，Wayland 需 wl-copy。

快速开始

1. 准备环境

安装 WPS Office 和 uv，并确认平台环境满足以下要求：

平台	Python	原生环境
Windows	3.11+	WPS 已注册 COM 接口
Linux x86_64	CPython 3.11	WPS Linux、Qt5、已登录的 X11 或带 XWayland 的桌面

2. 配置 MCP 客户端

将下文配置添加到 MCP 配置文件中，推荐通过 PyPI 接入。

从PyPI接入（Windows）

{
  "mcpServers": {
    "wps": {
      "command": "uvx",
      "args": ["wps-mcp@latest"]
    }
  }
}

如需使用预发布版，将 args 改为 ["--prerelease", "allow", "wps-mcp@latest"]。

从PyPI接入（Linux）

Linux 必须指定 CPython 3.11。

{
  "mcpServers": {
    "wps": {
      "command": "uvx",
      "args": ["--no-config", "--python", "3.11", "wps-mcp@latest"]
    }
  }
}

如需使用预发布版，将 args 改为 ["--no-config", "--python", "3.11", "--prerelease", "allow", "wps-mcp@latest"]。

Run in a desktop session with DISPLAY and X authority

遇到此错误时，需要将当前 Linux 桌面会话的环境变量转发给 WPS MCP。以下为 Claude Code 和 Codex 的配置示例。

Claude Code

{
  "mcpServers": {
    "wps": {
      "command": "uvx",
      "args": ["--no-config", "--python", "3.11", "wps-mcp@latest"],
      "env": {
        "DISPLAY": "${DISPLAY}",
        "XAUTHORITY": "${XAUTHORITY:-}",
        "WAYLAND_DISPLAY": "${WAYLAND_DISPLAY:-}",
        "XDG_RUNTIME_DIR": "${XDG_RUNTIME_DIR:-}",
        "DBUS_SESSION_BUS_ADDRESS": "${DBUS_SESSION_BUS_ADDRESS:-}"
      }
    }
  }
}

Codex

[mcp_servers.wps]
command = "uvx"
args = ["--no-config", "--python", "3.11", "wps-mcp@latest"]
env_vars = [
  "DISPLAY",
  "XAUTHORITY",
  "WAYLAND_DISPLAY",
  "XDG_RUNTIME_DIR",
  "DBUS_SESSION_BUS_ADDRESS"
]

从源码接入（可选）

如需本地开发，克隆项目后按对应平台安装依赖，并将配置中的 项目的绝对路径 替换为实际路径。

Windows

在项目根目录运行：

uv sync --locked

在 MCP 配置文件中添加：

{
  "mcpServers": {
    "wps": {
      "command": "uv",
      "args": [
        "--directory", "项目的绝对路径",
        "run", "wps-mcp"
      ]
    }
  }
}

Linux

在项目根目录运行：

uv sync --locked --python 3.11

在 MCP 配置文件中添加：

{
  "mcpServers": {
    "wps": {
      "command": "uv",
      "args": [
        "--directory", "项目的绝对路径",
        "run", "--python", "3.11", "wps-mcp"
      ]
    }
  }
}

_{论坛 · LINUX DO}

Metadata

Release files for wps-mcp 2026.10.25

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wps-mcp 2026.10.25
File	Size	Uploaded	Provenance
wps_mcp-2026.10.25.tar.gz	369.4 kB	Oct 25, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for wps-mcp 2026.10.25
File	Interpreter	ABI	Platform	Reset
wps_mcp-2026.10.25-py3-none-any.whl 252.9 kB Oct 25, 2026 With provenance	Python 3	none	any	Details

Total release size: 622.4 kB

Release files / wps_mcp-2026.10.25.tar.gz

Download URL	wps_mcp-2026.10.25.tar.gz
Size	369.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`45439d3c9e33b94ef37cb53ec3b40ca518a113bb540ea14874edc2b862bbc229`
BLAKE2b-256 checksum How to use checksums	`b21381aafcc4e55f643911d31f0de46abcaed15a9bd0af41b7d27ba56d0d9471`
Upload date	Oct 25, 2026
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ELDment/wps-mcp
Publishing commit: github.com/ELDment/wps-mcp/tree/e83f05ddcdb33ebaead86e8c8a3847ad2ce33d0a

Workflow

Publishing configuration: github.com/ELDment/wps-mcp/blob/e83f05ddcdb33ebaead86e8c8a3847ad2ce33d0a/.github/workflows/publish.yml
Publishing logs: github.com/ELDment/wps-mcp/actions/runs/40165306799/attempts/1

Artifact

Subject: wps_mcp-2026.10.25.tar.gz
SHA-256 checksum: 45439d3c9e33b94ef37cb53ec3b40ca518a113bb540ea14874edc2b862bbc229 Verifying attestations

Release files / wps_mcp-2026.10.25-py3-none-any.whl

Download URL	wps_mcp-2026.10.25-py3-none-any.whl
Size	252.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ed3c612dae9a7eba19cc6062ef327a49849a4ebc5f649f30a4f067579477cf7d`
BLAKE2b-256 checksum How to use checksums	`c5c623e59b41c01bca7890b84b093f2b80e6fe74e826cd32194509124ce3b0c1`
Upload date	Oct 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.16`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ELDment/wps-mcp
Publishing commit: github.com/ELDment/wps-mcp/tree/e83f05ddcdb33ebaead86e8c8a3847ad2ce33d0a

Workflow

Publishing configuration: github.com/ELDment/wps-mcp/blob/e83f05ddcdb33ebaead86e8c8a3847ad2ce33d0a/.github/workflows/publish.yml
Publishing logs: github.com/ELDment/wps-mcp/actions/runs/40165306799/attempts/1

Artifact

Subject: wps_mcp-2026.10.25-py3-none-any.whl
SHA-256 checksum: ed3c612dae9a7eba19cc6062ef327a49849a4ebc5f649f30a4f067579477cf7d Verifying attestations

Security for wps-mcp 2026.10.25

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for wps_mcp-2026.10.25.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ELDment/wps-mcp
Publishing commit: github.com/ELDment/wps-mcp/tree/e83f05ddcdb33ebaead86e8c8a3847ad2ce33d0a

Workflow

Publishing configuration: github.com/ELDment/wps-mcp/blob/e83f05ddcdb33ebaead86e8c8a3847ad2ce33d0a/.github/workflows/publish.yml
Publishing logs: github.com/ELDment/wps-mcp/actions/runs/40165306799/attempts/1

Artifact

Subject: wps_mcp-2026.10.25.tar.gz
SHA-256 checksum: 45439d3c9e33b94ef37cb53ec3b40ca518a113bb540ea14874edc2b862bbc229 Verifying attestations

A 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.