内容
# WPS MCP Server · WPS 办公套件的 AI 原生操作
> 与其手动打开 WPS 慢慢编辑，不如让 AI 直接帮你搞定文档、表格、幻灯片
[](https://opensource.org/licenses/MIT)
[](https://claude.com)
[](https://cursor.com)
[](https://www.wps.cn/)
---
## 中文 | [English](#english)
### 这是什么？
一个让 AI Agent **原生操作 WPS Office** 的 MCP Server。
不用手动打开 WPS，不用慢慢排版。直接告诉 AI 你想做什么，它帮你完成。
> **注意**：WPS 和 Microsoft Office 使用相同的文件格式（.docx、.xlsx、.pptx），所以这个服务器**同时兼容 WPS 和 Office**！
### 问题
```
你日常做的事 AI 帮你做的事
─────────────────────────────────────────────────
"帮我创建个周报文档" → 直接生成 .docx 文件
"在表格里填入这些数据" → 自动写入 Excel
"做个产品介绍 PPT" → 自动生成幻灯片
```
**问题在哪？**
> AI 只能"建议"你做什么，而不是"替"你做什么。
> 你还是要自己动手打开软件、复制粘贴。
### 解决
```python
# 用自然语言操作 WPS
create_document("周报", "本周工作总结") # 创建文档
add_heading("周报", "工作内容", 2) # 添加标题
write_cell("销售数据", "A1", "100万") # 写入表格
create_presentation("产品介绍", "XX产品") # 创建 PPT
```
### 支持的工具
#### 📄 文档 (Word)
| 工具 | 功能 |
|------|------|
| `create_document` | 创建新文档 |
| `add_heading` | 添加标题 |
| `add_paragraph` | 添加段落 |
| `read_document` | 读取文档内容 |
#### 📊 表格 (Excel)
| 工具 | 功能 |
|------|------|
| `create_spreadsheet` | 创建新表格 |
| `write_cell` | 写入单元格 |
| `read_cell` | 读取单元格 |
| `add_formula` | 添加公式 |
#### 📽️ 演示 (PowerPoint)
| 工具 | 功能 |
|------|------|
| `create_presentation` | 创建新演示文稿 |
| `add_slide` | 添加幻灯片 |
| `add_text_to_slide` | 添加文本框 |
| `set_slide_layout` | 设置布局 |
### 支持的平台
| 平台 | 配置文件位置 | 说明 |
|------|-------------|------|
| Claude Code | `~/.claude/settings.local.json` | Anthropic 官方 |
| Cursor | `~/.cursor/mcp.json` | VS Code 分支，AI 功能强 |
| VS Code (Insider) | `~/.cursor/mcp.json` | 需要 Insider 版本 |
| OpenClaw | `~/.openclaw/mcp.json` | 开源 AI Agent 框架 |
### 快速开始
#### 1. 安装依赖
```bash
pip install mcp python-docx openpyxl python-pptx
```
#### 2. 配置环境变量（可选）
```bash
# 设置工作目录，默认是 ~/wps_projects
export WPS_WORKSPACE="/path/to/your/folder"
```
#### 3. 配置 MCP Server
**Claude Code** (`~/.claude/settings.local.json`)
```json
{
"mcpServers": {
"wps": {
"command": "python",
"args": ["/path/to/wps_mcp.py"]
}
}
}
```
**Cursor / VS Code Insider** (`~/.cursor/mcp.json`)
```json
{
"mcpServers": {
"wps": {
"command": "python",
"args": ["C:\\path\\to\\wps_mcp.py"]
}
}
}
```
**OpenClaw** (`~/.openclaw/mcp.json`)
```json
{
"mcpServers": {
"wps": {
"command": "python",
"args": ["/path/to/wps_mcp.py"]
}
}
}
```
#### 4. 开始对话
```bash
# 启动 Claude Code 后，直接说：
"帮我创建一份周报文档"
"在表格里填入本月销售数据"
"做一个 5 页的产品介绍 PPT"
```
### 使用示例
#### 创建文档
```
"帮我创建一个项目报告文档"
AI → create_document("项目报告", "项目报告") → 返回文件路径
```
#### 操作表格
```
"在销售数据.xlsx 的 A1 写入 100万"
AI → write_cell("销售数据", "A1", "100万") → 完成
"帮我计算 A1 到 A10 的总和"
AI → add_formula("销售数据", "A11", "=SUM(A1:A10)") → 完成
```
#### 制作 PPT
```
"创建一个公司介绍 PPT"
AI → create_presentation("公司介绍", "XX公司") → 创建完成
"添加一页新幻灯片"
AI → add_slide("公司介绍", 1) → 幻灯片添加成功
```
### 为什么选 WPS？
| 优势 | 说明 |
|------|------|
| 🇨🇳 **中国市场** | WPS 在中国有 1 亿日活设备 |
| 🏛️ **政府采购** | 政府机关首选 WPS |
| 📄 **格式兼容** | 同时支持 .docx、.xlsx、.pptx |
| 🔧 **易于使用** | python-docx/openpyxl/pptx 生态成熟 |
### 技术栈
- Python 3.10+
- [FastMCP](https://modelcontextprotocol.io/) - MCP 框架
- [python-docx](https://python-docx.readthedocs.io/) - Word 文档
- [openpyxl](https://openpyxl.readthedocs.io/) - Excel 表格
- [python-pptx](https://python-pptx.readthedocs.io/) - PPT 幻灯片
---
### License
MIT
---
## English
An MCP server for WPS Office operations - enables AI agents to create, edit, and manage documents, spreadsheets, and presentations via natural language.
> **Note**: WPS and Microsoft Office use the same file formats (.docx, .xlsx, .pptx), so this server works with **both WPS and MS Office**!
### Features
- **Documents** - Create and edit Word (.docx) files
- **Spreadsheets** - Work with Excel (.xlsx) files
- **Presentations** - Build PowerPoint (.pptx) slideshows
### Quick Start
```bash
pip install mcp python-docx openpyxl python-pptx
python wps_mcp.py
```
Configure in Claude Code and start chatting!
