Metadata-Version: 2.5
Name: wps-mcp
Version: 2026.10.23
Summary: WPS Writer, ET and WPP automation for AI clients
Author: ELDment
License-Expression: AGPL-3.0-only
License-File: LICENSE
Keywords: automation,mcp,presentation,spreadsheet,wps,writer
Requires-Python: >=3.11
Requires-Dist: anyio<5.0.0,>=4.0.0
Requires-Dist: mcp<3.0.0,>=2.3.0
Requires-Dist: pillow>=10.0.0
Requires-Dist: pydantic<3.0.0,>=2.0.0
Requires-Dist: pypdfium2<6.0.0,>=4.30.0
Requires-Dist: pywin32>=306; sys_platform == 'win32'
Description-Content-Type: text/markdown

# WPS MCP

**让 AI 直接操作你正在使用的 WPS。**

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

## 核心能力

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

覆盖 **45 个工具组、261 项操作**，重点支持：

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

## 快速开始

需要 **Windows（Linux 和 macOS 兼容版仍在开发中）、Python 3.11+、WPS Office（已注册 COM 接口）** 和 **[uv](https://docs.astral.sh/uv/)**。

推荐通过 ***PyPI*** 接入，`uvx` 会自动安装并启动服务。**在 MCP 配置文件中添加**：

```json
{
  "mcpServers": {
    "wps": {
      "command": "uvx",
      "args": ["wps-mcp"]
    }
  }
}
```

<details>
<summary>本地接入</summary>

克隆项目后，在项目根目录安装依赖：

```powershell
uv sync --locked
```

在 MCP 配置文件中添加：

```json
{
  "mcpServers": {
    "wps": {
      "command": "uv",
      "args": [
        "--directory", "真实项目路径",
        "run", "wps-mcp"
      ]
    }
  }
}
```

</details>

---

<p align="right">
  <sub>许可证 · <a href="LICENSE" title="GNU Affero General Public License v3.0（仅第 3 版）">AGPL-3.0-only</a></sub>
</p>
