Skip to content
Back to search

wps-mcp-skills

MarketplaceWorks with Claude CodeGitHub

WPS Skills | WPS Office 智能助手 | WPS Office AI Assistant

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lc2panda-wps-skills/badge.svg)](/listings/lc2panda-wps-skills)

HTML

<a href="/listings/lc2panda-wps-skills"><img src="/api/listings/lc2panda-wps-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 25 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "wps-mcp-skills",
  3. "owner": {
  4. "name": "lc2panda",
  5. "email": "lc2panda@github.com"
  6. },
  7. "metadata": {
  8. "description": "WPS Office AI Assistant Skills - Control WPS Office with natural language",
  9. "version": "1.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "wps-office-skills",
  14. "description": "Complete WPS Office automation skills including Excel formula generation, Word formatting, PPT beautification, and cross-app operations",
  15. "source": "./",
  16. "strict": false,
  17. "skills": [
  18. "./skills/wps-excel",
  19. "./skills/wps-word",
  20. "./skills/wps-ppt",
  21. "./skills/wps-office"
  22. ]
  23. }
  24. ]
  25. }
README.md · README · 153 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # WPS Skills
  2. > 此项目的任何功能、架构更新,必须在结束后同步更新相关文档。这是我们契约的一部分。
  3. AI编程助手通过自然语言操控WPS Office的MCP工具集。
  4. ## 项目定位
  5. 本项目是MCP Server + Skills框架,让AI助手(Claude Code/Cursor/Augment等)能操控WPS Office。
  6. - 231个MCP专业工具 + 12个内置工具 = 243个
  7. - 支持Excel(82工具) / Word(28工具) / PPT(112工具) / 通用(9工具)
  8. - 支持macOS、Windows、Linux
  9. ## 前提条件
  10. - 已安装 WPS Office(https://www.wps.cn/ 或 https://www.wps.com/)
  11. - Node.js >= 18.0.0
  12. - Git
  13. ## 自动安装(AI执行)
  14. 以下步骤由AI助手自动执行。需要人类交互的步骤标注 ⚠️。
  15. ### 步骤1: 克隆项目
  16. ```bash
  17. git clone https://github.com/lc2panda/wps-skills.git
  18. cd wps-skills
  19. ```
  20. 如果项目已存在,跳过此步。
  21. ### 步骤2: 安装依赖并编译
  22. ```bash
  23. cd wps-office-mcp
  24. npm install
  25. npm run build
  26. cd ..
  27. ```
  28. ### 步骤3: 配置MCP Server
  29. 根据使用的AI工具,将以下配置写入对应文件。注意将路径替换为实际的项目绝对路径。
  30. **Claude Code** — 写入 `~/.claude/settings.json`:
  31. ```json
  32. {
  33. "mcpServers": {
  34. "wps-office": {
  35. "command": "node",
  36. "args": ["/你的路径/wps-skills/wps-office-mcp/dist/index.js"]
  37. }
  38. }
  39. }
  40. ```
  41. **Cursor** — 写入项目根目录 `.cursor/mcp.json`:
  42. ```json
  43. {
  44. "mcpServers": {
  45. "wps-office": {
  46. "command": "node",
  47. "args": ["/你的路径/wps-skills/wps-office-mcp/dist/index.js"]
  48. }
  49. }
  50. }
  51. ```
  52. **OpenAI Codex CLI** — 写入 `~/.codex/config.toml`:
  53. ```toml
  54. [mcp_servers.wps-office]
  55. command = "node"
  56. args = ["/你的路径/wps-skills/wps-office-mcp/dist/index.js"]
  57. ```
  58. 或命令行注册:`codex mcp add wps-office -- node /你的路径/wps-skills/wps-office-mcp/dist/index.js`
  59. **Augment / 其他MCP兼容IDE** — 参考各IDE的MCP Server配置文档,使用相同的command和args。本项目 MCP Server 为标准 stdio 实现(spec 2025-11-25),与所有 MCP 一等客户端(Claude Code / Cursor / Codex CLI / GitHub Copilot CLI / Windsurf 等)兼容。
  60. ### 步骤4: 安装WPS加载项
  61. ⚠️ 需要人工操作(AI无法直接操作WPS应用):
  62. ```bash
  63. # macOS
  64. bash scripts/auto-install-mac.sh
  65. # Windows (PowerShell)
  66. powershell scripts/install.ps1
  67. # Linux
  68. bash scripts/install.sh
  69. ```
  70. ⚠️ 安装后必须重启WPS Office才能生效。
  71. ### 步骤5: 安装Skills(仅Claude Code需要)
  72. ```bash
  73. # 创建skills目录(如不存在)
  74. mkdir -p ~/.claude/skills
  75. # 创建符号链接
  76. ln -sf "$(pwd)/skills/wps-excel" ~/.claude/skills/wps-excel
  77. ln -sf "$(pwd)/skills/wps-word" ~/.claude/skills/wps-word
  78. ln -sf "$(pwd)/skills/wps-ppt" ~/.claude/skills/wps-ppt
  79. ln -sf "$(pwd)/skills/wps-office" ~/.claude/skills/wps-office
  80. ```
  81. ### 步骤6: 验证安装
  82. ```bash
  83. # 验证MCP Server可启动
  84. node wps-office-mcp/dist/index.js &
  85. # 应看到 "MCP Server started successfully" 日志
  86. kill %1 2>/dev/null
  87. ```
  88. ## 架构
  89. ```
  90. Skills层(SKILL.md自然语言指导)
  91. ↓ Claude Code调用
  92. MCP Server层(239个工具)
  93. ↓ wpsClient.executeMethod()
  94. 执行层
  95. ├── macOS: wps-claude-assistant (227 action, HTTP轮询)
  96. └── Windows: wps-com.ps1 (231 action, COM接口)
  97. ```
  98. ## 工具清单
  99. | 应用 | 工具数 | 主要能力 |
  100. |------|--------|---------|
  101. | Excel | 82 | 公式/数据/图表/透视表/工作表/格式/工作簿/行列/批注保护/图片导出 |
  102. | Word | 28 | 格式/内容/文档管理/页眉页脚/批注/模板填写/段落结构 |
  103. | PPT | 112 | 幻灯片/形状/图片/表格/美化/动画/图表/3D/数据可视化/图片导出 |
  104. | 通用 | 9 | 保存/连接检测/文本选取/格式转换 |
  105. | 内置 | 12 | 连接检查/万能方法调用/数据缓存 |
  106. ## 故障排除
  107. | 问题 | 解决方案 |
  108. |------|---------|
  109. | MCP连接失败 | 确认 `npm install && npm run build` 已执行,检查dist/index.js存在 |
  110. | WPS未响应 | 重启WPS Office,确认加载项已安装 |
  111. | "arguments error" | 重新运行安装脚本,重启WPS |
  112. | Linux找不到插件 | 查看INSTALL.md中的Linux专用指南 |
  113. | 工具调用返回null | 确认WPS中已打开对应类型的文档 |
  114. ## 许可证
  115. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.