WPS Office MCP 服务器

关键词

WPS 办公自动化本地服务脚本化工具跨应用数据传递AI 助手集成

使用说明

  • 项目简介
    • 该仓库实现了基于 MCP 的本地后端服务器，专门用于向 LLM 客户端（如 Claude、Claude Code 等）提供对 WPS Office 的上下文服务。核心包括：资源与数据访问、工具注册与执行、以及提示模板（Prompts）的渲染与管理。服务器通过 JSON-RPC 规范与客户端进行通信，支持会话管理与能力声明，核心传输采用标准的 Stdio 传输实现。
  • 主要功能点
    • MCP 服务器核心：接收并处理 MCP 协议定义的请求，返回标准的 JSON-RPC 响应或通知。
    • 资源与数据访问：提供对资源的读取、写入、数据处理等能力（通过内置的 Tools 与 WPS 客户端实现）。
    • 工具注册与执行：内置 224 个 MCP Tool，涵盖 Excel/Word/PPT 的底层操作，以及一些跨应用的通用功能，支持动态注册与执行。
    • WPS 操作封装：通过 WPS 客户端对 WPS 应用（Word、Excel、PowerPoint）进行数据交互与操作。
    • 数据跨应用传递与缓存：跨应用数据缓存机制，解决多应用间的数据传递问题。
    • 基于标准 MCP 架构的插件化设计，方便扩展新的工具、资源和提示模板。
  • 安装步骤
    1. 克隆仓库并进入项目目录。
    2. 安装依赖并构建：
      • npm install
      • npm run build
    3. 将 MCP 服务注册到 Claude Code（或其他 Claude 实现的 MCP 客户端）：
      • claude mcp add wps-office node /path/to/your/project/dist/index.js
    4. 配置 Skills（可选，按 README 提示创建软链接并确保 Claude Code 能加载技能包）。
    5. 启动 Claude Code 与 WPS Office（按平台要求安装相应插件，确保 WPS 能正确访问 MCP 服务）。
  • 服务器配置（MCP 客户端配置示例，不需要修改客户端，仅用于理解配置要点）
    • serverName: wps-office-mcp
    • command: node
    • args: ["/path/to/your/project/dist/index.js"] 注释：
    • serverName：MCP 服务在客户端的唯一标识，一般与部署的实际服务名称一致，这里为 wps-office-mcp。
    • command：用于启动 MCP 服务的命令，在本仓库中默认通过 Node.js 启动打包后的脚本。
    • args：传入启动脚本的参数，这里通常指向 dist/index.js 的可执行入口。
  • 基本使用方法
    • 启动后，客户端（如 Claude）可以向 MCP 服务器发起工具调用、查询工具列表、执行资源操作等请求。
    • 通过内置工具注册与管理，开发者可扩展更多 Excel/Word/PPT 的操作能力，以及跨应用的数据传递功能。

服务器信息

访问项目