This project provides an AI-powered assistant framework for controlling WPS Office functionalities using natural language. It targets developers and power users seeking to automate document creation and manipulation tasks across Excel, Word, and PowerPoint, offering a bridge between AI programming assistants and WPS Office's extensive toolset.

How It Works

The architecture comprises a Skills layer for natural language interpretation, an MCP Server layer that exposes 243 WPS Office MCP tools, and an execution layer that interfaces with WPS Office via platform-specific scripts. The MCP Server implements a standard stdio protocol, ensuring compatibility with various AI clients like Claude Code and Cursor, translating AI commands into actionable WPS Office operations.

Quick Start & Requirements

• Primary install/run command: Clone the repository, navigate to wps-office-mcp, run npm install, and then npm run build. Configuration involves writing specific JSON/TOML files for your AI tool (e.g., ~/.claude/settings.json, .cursor/mcp.json) with the absolute path to the project's dist/index.js.
• Non-default prerequisites: WPS Office (download from wps.cn or wps.com), Node.js >= 18.0.0, and Git are required.
• Manual Steps: Installation of WPS add-ons requires running platform-specific scripts (scripts/auto-install-mac.sh, scripts/install.ps1, scripts/install.sh) and restarting WPS Office. Claude Code users also need to create symbolic links for skills.
• Links: WPS Office download pages are provided.

Highlighted Details

• Provides access to 243 MCP tools (231 professional + 12 built-in).
• Supports Excel (82 tools), Word (28 tools), and PPT (112 tools), along with general utilities.
• Cross-platform compatibility for macOS, Windows, and Linux.

Maintenance & Community

The project emphasizes synchronizing documentation updates with any functional or architectural changes. No specific community channels (like Discord or Slack) or details on notable contributors were found in the provided README.

Licensing & Compatibility

• License type: MIT.
• Compatibility notes: The MIT license generally permits commercial use and integration within closed-source projects.

Limitations & Caveats

Users must manually install WPS add-ons and restart the application for changes to take effect. Tool invocation may fail if the relevant WPS document type is not currently open. Specific installation instructions for Linux may require consulting additional documentation.