Content
# Tool List
> Let AI handle your WPS Office tasks directly, instead of manually opening and editing.
[](https://opensource.org/licenses/MIT)
[](https://claude.com)
[](https://cursor.com)
[](https://www.wps.cn/)
---
## English
### What is this?
An MCP server for native 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 Office**!
### Problems
```
What you do daily What AI can do for you
─────────────────────────────────────────────────
"Create a weekly report document" → Generate .docx file directly
"Fill in data in the spreadsheet" → Automatically write to Excel
"Make a product introduction PPT" → Automatically generate slides
```
**What's the issue?**
> AI can only **suggest** what to do, not **do** it for you.
> You still have to manually open software and copy-paste.
### Solution
```python
# Operate WPS with natural language
create_document("Weekly Report", "This week's summary") # Create document
add_heading("Weekly Report", "Work Content", 2) # Add heading
write_cell("Sales Data", "A1", "1 million") # Write to cell
create_presentation("Product Introduction", "XX Product") # Create PPT
```
### Supported Tools
#### 📄 Documents (Word)
| Tool | Function |
|------|------|
| `create_document` | Create new document |
| `add_heading` | Add heading |
| `add_paragraph` | Add paragraph |
| `read_document` | Read document content |
#### 📊 Spreadsheets (Excel)
| Tool | Function |
|------|------|
| `create_spreadsheet` | Create new spreadsheet |
| `write_cell` | Write to cell |
| `read_cell` | Read cell |
| `add_formula` | Add formula |
#### 📽️ Presentations (PowerPoint)
| Tool | Function |
|------|------|
| `create_presentation` | Create new presentation |
| `add_slide` | Add slide |
| `add_text_to_slide` | Add text box |
| `set_slide_layout` | Set layout |
### Supported Platforms
| Platform | Config File Location | Description |
|------|-------------|------|
| Claude Code | `~/.claude/settings.local.json` | Anthropic official |
| Cursor | `~/.cursor/mcp.json` | VS Code branch, strong AI capabilities |
| VS Code (Insider) | `~/.cursor/mcp.json` | Requires Insider version |
| OpenClaw | `~/.openclaw/mcp.json` | Open-source AI Agent framework |
### Quick Start
#### 1. Install Dependencies
```bash
pip install mcp python-docx openpyxl python-pptx
```
#### 2. Configure Environment Variables (optional)
```bash
# Set workspace directory, default is ~/wps_projects
export WPS_WORKSPACE="/path/to/your/folder"
```
#### 3. Configure 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. Start Chatting
```bash
# After launching Claude Code, just say:
"Create a weekly report document"
"Fill in this month's sales data in the spreadsheet"
"Make a 5-page product introduction PPT"
```
### Usage Examples
#### Create Document
```
"Create a project report document"
AI → create_document("Project Report", "Project Report") → Return file path
```
#### Operate Spreadsheet
```
"Write 1 million in cell A1 of sales data.xlsx"
AI → write_cell("Sales Data", "A1", "1 million") → Done
"Calculate the sum of A1 to A10"
AI → add_formula("Sales Data", "A11", "=SUM(A1:A10)") → Done
```
#### Make PPT
```
"Create a company introduction PPT"
AI → create_presentation("Company Introduction", "XX Company") → Created
"Add a new slide"
AI → add_slide("Company Introduction", 1) → Slide added successfully
```
### Why Choose WPS?
| Advantage | Description |
|------|------|
| 🇨🇳 **Chinese Market** | WPS has 100 million daily active devices in China |
| 🏛️ **Government Procurement** | Government agencies prefer WPS |
| 📄 **Format Compatibility** | Supports .docx, .xlsx, .pptx |
| 🔧 **Ease of Use** | python-docx/openpyxl/pptx ecosystem is mature |
### Tech Stack
- Python 3.10+
- [FastMCP](https://modelcontextprotocol.io/) - MCP framework
- [python-docx](https://python-docx.readthedocs.io/) - Word documents
- [openpyxl](https://openpyxl.readthedocs.io/) - Excel spreadsheets
- [python-pptx](https://python-pptx.readthedocs.io/) - PPT slideshows
---
### License
MIT
