Pre-release

This release is a pre-release and may not be stable for production use.

WPS MCP

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

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

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

核心能力

实时编辑	原生可编辑	预览与导出
创建新文档，或接着修改已打开的文件，随时在 WPS 中查看结果。	文字、表格、图表和形状保留原生结构，方便继续手动调整。	编辑后查看页面预览，保存文档或导出 PDF。

覆盖三大办公组件

组件	典型任务
WPS 文字	报告排版、表格与图片、样式、修订、引用与邮件合并
WPS 表格	数据整理、公式、图表、透视表、条件格式与数据验证
WPS 演示	幻灯片制作、文字与形状排版、图片、主题、动画与导出

快速开始

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

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.dev5
File	Size	Uploaded	Provenance
wps_mcp-2026.10.25.dev5.tar.gz	367.4 kB	Oct 25, 2026	With provenance	Details

Built distribution (wheel)

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

Total release size: 619.2 kB

Release files / wps_mcp-2026.10.25.dev5.tar.gz

Download URL	wps_mcp-2026.10.25.dev5.tar.gz
Size	367.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`4fc0625ff045dcaa2e828ec665a61955446e0a86bc029b154c90805650bdc58f`
BLAKE2b-256 checksum How to use checksums	`980ad82c3224d1647f2d3c129913ac2733f27d84795d8075e727dd7d8c0efe18`
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/0d3dc832dc0a7fe4c4e9c0f06d96a20715bbe95c

Workflow

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

Artifact

Subject: wps_mcp-2026.10.25.dev5.tar.gz
SHA-256 checksum: 4fc0625ff045dcaa2e828ec665a61955446e0a86bc029b154c90805650bdc58f Verifying attestations

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

Download URL	wps_mcp-2026.10.25.dev5-py3-none-any.whl
Size	251.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1ad90fc14ef774165499defe7801c66e54b3a84804f53df0031395ced5009037`
BLAKE2b-256 checksum How to use checksums	`a3b4bb466305f34d49087e89de4093d47b2e656d44f537deaeea5e293fbe16b7`
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/0d3dc832dc0a7fe4c4e9c0f06d96a20715bbe95c

Workflow

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

Artifact

Subject: wps_mcp-2026.10.25.dev5-py3-none-any.whl
SHA-256 checksum: 1ad90fc14ef774165499defe7801c66e54b3a84804f53df0031395ced5009037 Verifying attestations

Security for wps-mcp 2026.10.25.dev5

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.dev5.tar.gz

Identity

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

Workflow

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

Artifact

Subject: wps_mcp-2026.10.25.dev5.tar.gz
SHA-256 checksum: 4fc0625ff045dcaa2e828ec665a61955446e0a86bc029b154c90805650bdc58f 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.