wps-multitool-mcp 0.0.0-stage → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (280) hide show
  1. package/README.md +3 -3
  2. package/dist/bridge/cancellable.d.ts +36 -0
  3. package/dist/bridge/cancellable.d.ts.map +1 -0
  4. package/dist/bridge/cancellable.js +155 -0
  5. package/dist/bridge/cancellable.js.map +1 -0
  6. package/dist/bridge/index.d.ts +37 -0
  7. package/dist/bridge/index.d.ts.map +1 -0
  8. package/dist/bridge/index.js +381 -0
  9. package/dist/bridge/index.js.map +1 -0
  10. package/dist/bridge/ps-child.d.ts +155 -0
  11. package/dist/bridge/ps-child.d.ts.map +1 -0
  12. package/dist/bridge/ps-child.js +578 -0
  13. package/dist/bridge/ps-child.js.map +1 -0
  14. package/dist/client/action-routes.d.ts +32 -0
  15. package/dist/client/action-routes.d.ts.map +1 -0
  16. package/dist/client/action-routes.generated.d.ts +10 -0
  17. package/dist/client/action-routes.generated.d.ts.map +1 -0
  18. package/dist/client/action-routes.generated.js +322 -0
  19. package/dist/client/action-routes.generated.js.map +1 -0
  20. package/dist/client/action-routes.js +57 -0
  21. package/dist/client/action-routes.js.map +1 -0
  22. package/dist/client/mac-poll-server.d.ts +77 -0
  23. package/dist/client/mac-poll-server.d.ts.map +1 -0
  24. package/dist/client/mac-poll-server.js +516 -0
  25. package/dist/client/mac-poll-server.js.map +1 -0
  26. package/dist/client/ps-daemon.d.ts +95 -0
  27. package/dist/client/ps-daemon.d.ts.map +1 -0
  28. package/dist/client/ps-daemon.js +424 -0
  29. package/dist/client/ps-daemon.js.map +1 -0
  30. package/dist/client/wps-client.d.ts +72 -0
  31. package/dist/client/wps-client.d.ts.map +1 -0
  32. package/dist/client/wps-client.js +408 -0
  33. package/dist/client/wps-client.js.map +1 -0
  34. package/dist/index.d.ts +29 -0
  35. package/dist/index.d.ts.map +1 -0
  36. package/dist/index.js +121 -0
  37. package/dist/index.js.map +1 -0
  38. package/dist/runtime-identity.d.ts +23 -0
  39. package/dist/runtime-identity.d.ts.map +1 -0
  40. package/dist/runtime-identity.js +26 -0
  41. package/dist/runtime-identity.js.map +1 -0
  42. package/dist/server/cancel-context.d.ts +30 -0
  43. package/dist/server/cancel-context.d.ts.map +1 -0
  44. package/dist/server/cancel-context.js +38 -0
  45. package/dist/server/cancel-context.js.map +1 -0
  46. package/dist/server/mcp-server.d.ts +74 -0
  47. package/dist/server/mcp-server.d.ts.map +1 -0
  48. package/dist/server/mcp-server.js +725 -0
  49. package/dist/server/mcp-server.js.map +1 -0
  50. package/dist/server/server-info.d.ts +21 -0
  51. package/dist/server/server-info.d.ts.map +1 -0
  52. package/dist/server/server-info.js +56 -0
  53. package/dist/server/server-info.js.map +1 -0
  54. package/dist/server/tool-annotations.d.ts +52 -0
  55. package/dist/server/tool-annotations.d.ts.map +1 -0
  56. package/dist/server/tool-annotations.generated.d.ts +14 -0
  57. package/dist/server/tool-annotations.generated.d.ts.map +1 -0
  58. package/dist/server/tool-annotations.generated.js +324 -0
  59. package/dist/server/tool-annotations.generated.js.map +1 -0
  60. package/dist/server/tool-annotations.js +116 -0
  61. package/dist/server/tool-annotations.js.map +1 -0
  62. package/dist/server/tool-group-events.d.ts +23 -0
  63. package/dist/server/tool-group-events.d.ts.map +1 -0
  64. package/dist/server/tool-group-events.js +44 -0
  65. package/dist/server/tool-group-events.js.map +1 -0
  66. package/dist/server/tool-metadata.d.ts +43 -0
  67. package/dist/server/tool-metadata.d.ts.map +1 -0
  68. package/dist/server/tool-metadata.js +657 -0
  69. package/dist/server/tool-metadata.js.map +1 -0
  70. package/dist/server/tool-registry.d.ts +164 -0
  71. package/dist/server/tool-registry.d.ts.map +1 -0
  72. package/dist/server/tool-registry.js +453 -0
  73. package/dist/server/tool-registry.js.map +1 -0
  74. package/dist/server/tool-tiers.d.ts +39 -0
  75. package/dist/server/tool-tiers.d.ts.map +1 -0
  76. package/dist/server/tool-tiers.js +102 -0
  77. package/dist/server/tool-tiers.js.map +1 -0
  78. package/dist/tools/common/batch.d.ts +33 -0
  79. package/dist/tools/common/batch.d.ts.map +1 -0
  80. package/dist/tools/common/batch.js +195 -0
  81. package/dist/tools/common/batch.js.map +1 -0
  82. package/dist/tools/common/convert.d.ts +41 -0
  83. package/dist/tools/common/convert.d.ts.map +1 -0
  84. package/dist/tools/common/convert.js +299 -0
  85. package/dist/tools/common/convert.js.map +1 -0
  86. package/dist/tools/common/general.d.ts +39 -0
  87. package/dist/tools/common/general.d.ts.map +1 -0
  88. package/dist/tools/common/general.js +624 -0
  89. package/dist/tools/common/general.js.map +1 -0
  90. package/dist/tools/common/index.d.ts +36 -0
  91. package/dist/tools/common/index.d.ts.map +1 -0
  92. package/dist/tools/common/index.js +102 -0
  93. package/dist/tools/common/index.js.map +1 -0
  94. package/dist/tools/common/intent.d.ts +48 -0
  95. package/dist/tools/common/intent.d.ts.map +1 -0
  96. package/dist/tools/common/intent.js +221 -0
  97. package/dist/tools/common/intent.js.map +1 -0
  98. package/dist/tools/common/repair.d.ts +29 -0
  99. package/dist/tools/common/repair.d.ts.map +1 -0
  100. package/dist/tools/common/repair.js +140 -0
  101. package/dist/tools/common/repair.js.map +1 -0
  102. package/dist/tools/common/status.d.ts +27 -0
  103. package/dist/tools/common/status.d.ts.map +1 -0
  104. package/dist/tools/common/status.js +139 -0
  105. package/dist/tools/common/status.js.map +1 -0
  106. package/dist/tools/common/toolgroups.d.ts +38 -0
  107. package/dist/tools/common/toolgroups.d.ts.map +1 -0
  108. package/dist/tools/common/toolgroups.js +238 -0
  109. package/dist/tools/common/toolgroups.js.map +1 -0
  110. package/dist/tools/excel/chart.d.ts +86 -0
  111. package/dist/tools/excel/chart.d.ts.map +1 -0
  112. package/dist/tools/excel/chart.js +659 -0
  113. package/dist/tools/excel/chart.js.map +1 -0
  114. package/dist/tools/excel/comment-protect.d.ts +58 -0
  115. package/dist/tools/excel/comment-protect.d.ts.map +1 -0
  116. package/dist/tools/excel/comment-protect.js +274 -0
  117. package/dist/tools/excel/comment-protect.js.map +1 -0
  118. package/dist/tools/excel/data-advanced.d.ts +47 -0
  119. package/dist/tools/excel/data-advanced.d.ts.map +1 -0
  120. package/dist/tools/excel/data-advanced.js +263 -0
  121. package/dist/tools/excel/data-advanced.js.map +1 -0
  122. package/dist/tools/excel/data.d.ts +91 -0
  123. package/dist/tools/excel/data.d.ts.map +1 -0
  124. package/dist/tools/excel/data.js +626 -0
  125. package/dist/tools/excel/data.js.map +1 -0
  126. package/dist/tools/excel/format.d.ts +42 -0
  127. package/dist/tools/excel/format.d.ts.map +1 -0
  128. package/dist/tools/excel/format.js +715 -0
  129. package/dist/tools/excel/format.js.map +1 -0
  130. package/dist/tools/excel/formula.d.ts +64 -0
  131. package/dist/tools/excel/formula.d.ts.map +1 -0
  132. package/dist/tools/excel/formula.js +333 -0
  133. package/dist/tools/excel/formula.js.map +1 -0
  134. package/dist/tools/excel/index.d.ts +44 -0
  135. package/dist/tools/excel/index.d.ts.map +1 -0
  136. package/dist/tools/excel/index.js +249 -0
  137. package/dist/tools/excel/index.js.map +1 -0
  138. package/dist/tools/excel/pivot.d.ts +39 -0
  139. package/dist/tools/excel/pivot.d.ts.map +1 -0
  140. package/dist/tools/excel/pivot.js +455 -0
  141. package/dist/tools/excel/pivot.js.map +1 -0
  142. package/dist/tools/excel/row-column.d.ts +64 -0
  143. package/dist/tools/excel/row-column.d.ts.map +1 -0
  144. package/dist/tools/excel/row-column.js +299 -0
  145. package/dist/tools/excel/row-column.js.map +1 -0
  146. package/dist/tools/excel/sheet-gaps.d.ts +50 -0
  147. package/dist/tools/excel/sheet-gaps.d.ts.map +1 -0
  148. package/dist/tools/excel/sheet-gaps.js +373 -0
  149. package/dist/tools/excel/sheet-gaps.js.map +1 -0
  150. package/dist/tools/excel/sheet.d.ts +112 -0
  151. package/dist/tools/excel/sheet.d.ts.map +1 -0
  152. package/dist/tools/excel/sheet.js +937 -0
  153. package/dist/tools/excel/sheet.js.map +1 -0
  154. package/dist/tools/excel/workbook.d.ts +62 -0
  155. package/dist/tools/excel/workbook.d.ts.map +1 -0
  156. package/dist/tools/excel/workbook.js +366 -0
  157. package/dist/tools/excel/workbook.js.map +1 -0
  158. package/dist/tools/index.d.ts +48 -0
  159. package/dist/tools/index.d.ts.map +1 -0
  160. package/dist/tools/index.js +113 -0
  161. package/dist/tools/index.js.map +1 -0
  162. package/dist/tools/ppt/animation.d.ts +79 -0
  163. package/dist/tools/ppt/animation.d.ts.map +1 -0
  164. package/dist/tools/ppt/animation.js +719 -0
  165. package/dist/tools/ppt/animation.js.map +1 -0
  166. package/dist/tools/ppt/background.d.ts +72 -0
  167. package/dist/tools/ppt/background.d.ts.map +1 -0
  168. package/dist/tools/ppt/background.js +595 -0
  169. package/dist/tools/ppt/background.js.map +1 -0
  170. package/dist/tools/ppt/beautify-advanced.d.ts +72 -0
  171. package/dist/tools/ppt/beautify-advanced.d.ts.map +1 -0
  172. package/dist/tools/ppt/beautify-advanced.js +663 -0
  173. package/dist/tools/ppt/beautify-advanced.js.map +1 -0
  174. package/dist/tools/ppt/chart-flow.d.ts +58 -0
  175. package/dist/tools/ppt/chart-flow.d.ts.map +1 -0
  176. package/dist/tools/ppt/chart-flow.js +523 -0
  177. package/dist/tools/ppt/chart-flow.js.map +1 -0
  178. package/dist/tools/ppt/data-viz.d.ts +64 -0
  179. package/dist/tools/ppt/data-viz.d.ts.map +1 -0
  180. package/dist/tools/ppt/data-viz.js +514 -0
  181. package/dist/tools/ppt/data-viz.js.map +1 -0
  182. package/dist/tools/ppt/image.d.ts +30 -0
  183. package/dist/tools/ppt/image.d.ts.map +1 -0
  184. package/dist/tools/ppt/image.js +452 -0
  185. package/dist/tools/ppt/image.js.map +1 -0
  186. package/dist/tools/ppt/index.d.ts +72 -0
  187. package/dist/tools/ppt/index.d.ts.map +1 -0
  188. package/dist/tools/ppt/index.js +350 -0
  189. package/dist/tools/ppt/index.js.map +1 -0
  190. package/dist/tools/ppt/misc.d.ts +99 -0
  191. package/dist/tools/ppt/misc.d.ts.map +1 -0
  192. package/dist/tools/ppt/misc.js +868 -0
  193. package/dist/tools/ppt/misc.js.map +1 -0
  194. package/dist/tools/ppt/presentation.d.ts +72 -0
  195. package/dist/tools/ppt/presentation.d.ts.map +1 -0
  196. package/dist/tools/ppt/presentation.js +680 -0
  197. package/dist/tools/ppt/presentation.js.map +1 -0
  198. package/dist/tools/ppt/shape-basic.d.ts +46 -0
  199. package/dist/tools/ppt/shape-basic.d.ts.map +1 -0
  200. package/dist/tools/ppt/shape-basic.js +756 -0
  201. package/dist/tools/ppt/shape-basic.js.map +1 -0
  202. package/dist/tools/ppt/slide-ops.d.ts +79 -0
  203. package/dist/tools/ppt/slide-ops.d.ts.map +1 -0
  204. package/dist/tools/ppt/slide-ops.js +1646 -0
  205. package/dist/tools/ppt/slide-ops.js.map +1 -0
  206. package/dist/tools/ppt/slide.d.ts +51 -0
  207. package/dist/tools/ppt/slide.d.ts.map +1 -0
  208. package/dist/tools/ppt/slide.js +470 -0
  209. package/dist/tools/ppt/slide.js.map +1 -0
  210. package/dist/tools/ppt/table.d.ts +58 -0
  211. package/dist/tools/ppt/table.d.ts.map +1 -0
  212. package/dist/tools/ppt/table.js +512 -0
  213. package/dist/tools/ppt/table.js.map +1 -0
  214. package/dist/tools/ppt/textbox.d.ts +47 -0
  215. package/dist/tools/ppt/textbox.d.ts.map +1 -0
  216. package/dist/tools/ppt/textbox.js +246 -0
  217. package/dist/tools/ppt/textbox.js.map +1 -0
  218. package/dist/tools/word/academic.d.ts +50 -0
  219. package/dist/tools/word/academic.d.ts.map +1 -0
  220. package/dist/tools/word/academic.js +500 -0
  221. package/dist/tools/word/academic.js.map +1 -0
  222. package/dist/tools/word/content.d.ts +97 -0
  223. package/dist/tools/word/content.d.ts.map +1 -0
  224. package/dist/tools/word/content.js +838 -0
  225. package/dist/tools/word/content.js.map +1 -0
  226. package/dist/tools/word/document.d.ts +70 -0
  227. package/dist/tools/word/document.d.ts.map +1 -0
  228. package/dist/tools/word/document.js +633 -0
  229. package/dist/tools/word/document.js.map +1 -0
  230. package/dist/tools/word/format.d.ts +50 -0
  231. package/dist/tools/word/format.d.ts.map +1 -0
  232. package/dist/tools/word/format.js +462 -0
  233. package/dist/tools/word/format.js.map +1 -0
  234. package/dist/tools/word/gaps.d.ts +58 -0
  235. package/dist/tools/word/gaps.d.ts.map +1 -0
  236. package/dist/tools/word/gaps.js +431 -0
  237. package/dist/tools/word/gaps.js.map +1 -0
  238. package/dist/tools/word/index.d.ts +34 -0
  239. package/dist/tools/word/index.d.ts.map +1 -0
  240. package/dist/tools/word/index.js +124 -0
  241. package/dist/tools/word/index.js.map +1 -0
  242. package/dist/tools/word/professional.d.ts +48 -0
  243. package/dist/tools/word/professional.d.ts.map +1 -0
  244. package/dist/tools/word/professional.js +657 -0
  245. package/dist/tools/word/professional.js.map +1 -0
  246. package/dist/tools/word/proofread.d.ts +25 -0
  247. package/dist/tools/word/proofread.d.ts.map +1 -0
  248. package/dist/tools/word/proofread.js +718 -0
  249. package/dist/tools/word/proofread.js.map +1 -0
  250. package/dist/types/index.d.ts +9 -0
  251. package/dist/types/index.d.ts.map +1 -0
  252. package/dist/types/index.js +25 -0
  253. package/dist/types/index.js.map +1 -0
  254. package/dist/types/tools.d.ts +163 -0
  255. package/dist/types/tools.d.ts.map +1 -0
  256. package/dist/types/tools.js +45 -0
  257. package/dist/types/tools.js.map +1 -0
  258. package/dist/types/wps.d.ts +190 -0
  259. package/dist/types/wps.d.ts.map +1 -0
  260. package/dist/types/wps.js +23 -0
  261. package/dist/types/wps.js.map +1 -0
  262. package/dist/utils/error.d.ts +147 -0
  263. package/dist/utils/error.d.ts.map +1 -0
  264. package/dist/utils/error.js +417 -0
  265. package/dist/utils/error.js.map +1 -0
  266. package/dist/utils/logger.d.ts +56 -0
  267. package/dist/utils/logger.d.ts.map +1 -0
  268. package/dist/utils/logger.js +138 -0
  269. package/dist/utils/logger.js.map +1 -0
  270. package/dist/version.d.ts +22 -0
  271. package/dist/version.d.ts.map +1 -0
  272. package/dist/version.js +101 -0
  273. package/dist/version.js.map +1 -0
  274. package/package.json +57 -4
  275. package/scripts/wps-com.ps1 +7260 -0
  276. package/scripts/wps-comd.ps1 +123 -0
  277. package/skills/wps-multitool/SKILL.md +111 -0
  278. package/skills/wps-multitool/references/errors.md +62 -0
  279. package/skills/wps-multitool/references/recipes.md +82 -0
  280. package/skills/wps-multitool/references/routing.md +88 -0
@@ -0,0 +1,725 @@
1
+ "use strict";
2
+ /**
3
+ * Input: MCP 协议请求
4
+ * Output: Tool 调用响应
5
+ * Pos: MCP Server 核心实现。一旦我被修改,请更新我的头部注释,以及所属文件夹的md。
6
+ * MCP Server实现 - WPS 的 MCP 协议实现
7
+ * 这是整个系统的核心,处理MCP协议通信
8
+ * 基于stdio传输,Claude Desktop就是这么连的
9
+ */
10
+ Object.defineProperty(exports, "__esModule", { value: true });
11
+ exports.createMcpServer = exports.WpsMcpServer = void 0;
12
+ exports.prefixWithWarnings = prefixWithWarnings;
13
+ const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
14
+ const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
15
+ const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
16
+ const tool_registry_1 = require("./tool-registry");
17
+ const wps_client_1 = require("../client/wps-client");
18
+ const tools_1 = require("../types/tools");
19
+ const tools_2 = require("../tools");
20
+ const toolgroups_1 = require("../tools/common/toolgroups");
21
+ const logger_1 = require("../utils/logger");
22
+ const error_1 = require("../utils/error");
23
+ const cancel_context_1 = require("./cancel-context");
24
+ const tool_annotations_1 = require("./tool-annotations");
25
+ const server_info_1 = require("./server-info");
26
+ const cancellable_1 = require("../bridge/cancellable");
27
+ const version_1 = require("../version");
28
+ const logger = (0, logger_1.createChildLogger)('McpServer');
29
+ /**
30
+ * 默认配置
31
+ */
32
+ const DEFAULT_CONFIG = {
33
+ name: version_1.MCP_NAME,
34
+ // 版本号只有 package.json 一个真相源,见 src/version.ts
35
+ version: version_1.MCP_VERSION,
36
+ debug: false,
37
+ };
38
+ /**
39
+ * WPS MCP Server - 核心服务器类
40
+ */
41
+ class WpsMcpServer {
42
+ config;
43
+ server;
44
+ registry;
45
+ isRunning = false;
46
+ /** 工具组变更通知是否已接上(避免重复订阅) */
47
+ groupsNotifyWired = false;
48
+ static dataCache = new Map();
49
+ constructor(config) {
50
+ this.config = { ...DEFAULT_CONFIG, ...config };
51
+ this.registry = tool_registry_1.toolRegistry;
52
+ // 工具注册放在【构造期】而不是 start() 里 —— 因为 instructions(客户端第一眼
53
+ // 看到的介绍,含作者署名与真实工具数)在 new Server() 时就要定下来。
54
+ // registerBuiltinTools() 只依赖 this.registry,不碰 this.server,提前调用安全。
55
+ this.registerBuiltinTools();
56
+ this.registry.registerAll(tools_2.allTools);
57
+ // 介绍里的工具数从注册表数,不写死 —— 写死必随版本腐化
58
+ const toolCount = this.registry.listAllTools().length;
59
+ (0, server_info_1.setToolCount)(toolCount);
60
+ logger.info(`Registered ${toolCount} tools in total (builtin + professional)`);
61
+ // 创建MCP Server实例
62
+ this.server = new index_js_1.Server({
63
+ name: this.config.name,
64
+ version: this.config.version,
65
+ }, {
66
+ capabilities: {
67
+ tools: {},
68
+ },
69
+ // 介绍 + 作者署名:随 initialize 响应发给客户端。
70
+ instructions: (0, server_info_1.serverInstructions)(),
71
+ });
72
+ // 注册请求处理器
73
+ this.setupRequestHandlers();
74
+ // 错误处理
75
+ this.server.onerror = (error) => {
76
+ logger.error('MCP Server error', error);
77
+ };
78
+ logger.info('MCP Server created', {
79
+ name: this.config.name,
80
+ version: this.config.version,
81
+ });
82
+ }
83
+ /**
84
+ * 设置请求处理器
85
+ */
86
+ setupRequestHandlers() {
87
+ // 处理 tools/list 请求
88
+ this.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
89
+ logger.debug('Handling tools/list request');
90
+ // 只返回【已加载组】里的工具;未加载组的不列出(省上下文,见 wps_list_tool_groups)
91
+ const { tools } = this.registry.listTools();
92
+ const total = this.registry.listAllTools().length;
93
+ logger.info(`Returning ${tools.length} tools (已加载组) / 共 ${total}`, {
94
+ loadedGroups: this.registry.getLoadedGroups(),
95
+ });
96
+ return {
97
+ tools: tools.map((tool) => {
98
+ const annotations = (0, tool_annotations_1.getToolAnnotations)(tool.name);
99
+ return {
100
+ name: tool.name,
101
+ description: tool.description,
102
+ inputSchema: tool.inputSchema,
103
+ // 注解必须【嵌套】在 annotations 里。铺在顶层客户端会整个忽略 ——
104
+ // 这坑踩过:单测全绿,端到端才发现 40 个工具一个注解都没透出去。
105
+ ...(annotations ? { annotations } : {}),
106
+ };
107
+ }),
108
+ };
109
+ });
110
+ // 处理 tools/call 请求
111
+ this.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request, extra) => {
112
+ const { name, arguments: args } = request.params;
113
+ logger.debug('Handling tools/call request', { name, args });
114
+ // 客户端发 notifications/cancelled 时 extra.signal 会 abort。
115
+ // 把它放进 AsyncLocalStorage,调用链深处(wps-client → 桥 → 子进程)自己取,
116
+ // 不用改 285 个工具的签名。真正"能不能取消"由 bridge/cancellable.ts 裁决。
117
+ const signal = extra?.signal;
118
+ if (signal) {
119
+ signal.addEventListener('abort', () => logger.info('Tool call cancelled by client', { name }), { once: true });
120
+ }
121
+ const runIt = () => this.handleToolCall(name, args ?? {});
122
+ return signal ? (0, cancel_context_1.runWithCancel)({ signal, toolName: name }, runIt) : runIt();
123
+ });
124
+ }
125
+ /** tools/call 的实际处理(拆出来是为了好包取消上下文) */
126
+ async handleToolCall(name, args) {
127
+ {
128
+ // 检查Tool是否存在。不存在时给个线索:是不是"组没加载"?
129
+ if (!this.registry.hasTool(name)) {
130
+ const similar = this.registry.suggestSimilar(name);
131
+ const hint = similar.length
132
+ ? ` 近似工具:${similar
133
+ .map((s) => `${s.name}(${s.loaded ? '已列出' : `组 ${s.group} 未加载`})`)
134
+ .join('、')}`
135
+ : ' 可用 wps_search_tools 搜一下,或 wps_list_tool_groups 看有哪些组';
136
+ throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Unknown tool: ${name}。${hint}`);
137
+ }
138
+ try {
139
+ // 创建调用请求并执行
140
+ const callRequest = tool_registry_1.ToolRegistry.createRequest(name, args || {});
141
+ const result = await this.registry.callTool(callRequest);
142
+ // 失败时把错误类型 + 可重试性透出去(前缀形式,不改动 isError 语义)
143
+ // 形如 [busy|可重试·稍后退避] / [timeout|勿重试·可能已执行一半]
144
+ const content = result.success
145
+ ? prefixWithWarnings(result)
146
+ : result.content.map((c, i) => i === 0 && c.type === 'text' && typeof c.text === 'string' && result.errorType
147
+ ? {
148
+ ...c,
149
+ text: `${(0, error_1.formatWpsErrorTag)(result.errorType, result.retryable)} ${c.text}`,
150
+ }
151
+ : c);
152
+ return {
153
+ content,
154
+ isError: !result.success,
155
+ };
156
+ }
157
+ catch (error) {
158
+ // 取消不是故障:单独走一条,别记成 error 吓唬人
159
+ if (error instanceof cancellable_1.CancelError) {
160
+ logger.info('Tool call cancelled', { name, reason: error.message });
161
+ return {
162
+ content: [
163
+ {
164
+ type: 'text',
165
+ text: `${(0, error_1.formatWpsErrorTag)(error_1.WpsErrorType.CANCELLED, false)} ${error.message}`,
166
+ },
167
+ ],
168
+ isError: true,
169
+ };
170
+ }
171
+ logger.error('Tool call failed', error);
172
+ if (error instanceof error_1.McpError) {
173
+ return {
174
+ content: [
175
+ {
176
+ type: 'text',
177
+ text: `${(0, error_1.formatWpsErrorTag)(error.wpsType, error.retryable)} ${error.message}`,
178
+ },
179
+ ],
180
+ isError: true,
181
+ };
182
+ }
183
+ throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, error instanceof Error ? error.message : 'Unknown error');
184
+ }
185
+ }
186
+ }
187
+ /**
188
+ * 注册内置Tools - 一些基础的WPS操作Tool
189
+ */
190
+ registerBuiltinTools() {
191
+ logger.info('Registering built-in tools');
192
+ // 连接状态检查Tool
193
+ this.registry.register({
194
+ name: 'wps_check_connection',
195
+ description: '检查WPS Office连接状态',
196
+ inputSchema: {
197
+ type: 'object',
198
+ properties: {},
199
+ },
200
+ category: tools_1.ToolCategory.COMMON,
201
+ }, async () => {
202
+ const connected = await wps_client_1.wpsClient.checkConnection();
203
+ const status = wps_client_1.wpsClient.getStatus();
204
+ return {
205
+ id: '',
206
+ success: true,
207
+ content: [
208
+ {
209
+ type: 'text',
210
+ text: JSON.stringify({
211
+ connected,
212
+ status,
213
+ }),
214
+ },
215
+ ],
216
+ };
217
+ });
218
+ // 获取当前文档信息
219
+ this.registry.register({
220
+ name: 'wps_get_active_document',
221
+ description: '获取当前打开的WPS文字文档信息',
222
+ inputSchema: {
223
+ type: 'object',
224
+ properties: {},
225
+ },
226
+ category: tools_1.ToolCategory.DOCUMENT,
227
+ }, async () => {
228
+ const doc = await wps_client_1.wpsClient.getActiveDocument();
229
+ return {
230
+ id: '',
231
+ success: doc !== null,
232
+ content: [
233
+ {
234
+ type: 'text',
235
+ text: doc
236
+ ? JSON.stringify(doc)
237
+ : '没有打开的文档',
238
+ },
239
+ ],
240
+ };
241
+ });
242
+ // 在文档中插入文本
243
+ this.registry.register({
244
+ name: 'wps_insert_text',
245
+ description: '在当前文档中插入文本',
246
+ inputSchema: {
247
+ type: 'object',
248
+ properties: {
249
+ text: {
250
+ type: 'string',
251
+ description: '要插入的文本内容',
252
+ },
253
+ position: {
254
+ type: 'number',
255
+ description: '插入位置(可选,不指定则在光标处插入)',
256
+ },
257
+ },
258
+ required: ['text'],
259
+ },
260
+ category: tools_1.ToolCategory.DOCUMENT,
261
+ }, async (args) => {
262
+ const text = args.text;
263
+ const position = args.position;
264
+ const success = await wps_client_1.wpsClient.insertText(text, position);
265
+ return {
266
+ id: '',
267
+ success,
268
+ content: [
269
+ {
270
+ type: 'text',
271
+ text: success ? '文本插入成功' : '文本插入失败',
272
+ },
273
+ ],
274
+ };
275
+ });
276
+ // 获取当前工作簿信息
277
+ this.registry.register({
278
+ name: 'wps_get_active_workbook',
279
+ description: '获取当前打开的WPS表格工作簿信息',
280
+ inputSchema: {
281
+ type: 'object',
282
+ properties: {},
283
+ },
284
+ category: tools_1.ToolCategory.SPREADSHEET,
285
+ }, async () => {
286
+ const workbook = await wps_client_1.wpsClient.getActiveWorkbook();
287
+ return {
288
+ id: '',
289
+ success: workbook !== null,
290
+ content: [
291
+ {
292
+ type: 'text',
293
+ text: workbook
294
+ ? JSON.stringify(workbook)
295
+ : '没有打开的工作簿',
296
+ },
297
+ ],
298
+ };
299
+ });
300
+ // 读取单元格值
301
+ this.registry.register({
302
+ name: 'wps_get_cell_value',
303
+ description: '读取指定单元格的值',
304
+ inputSchema: {
305
+ type: 'object',
306
+ properties: {
307
+ sheet: {
308
+ type: 'string',
309
+ description: '工作表名称或索引',
310
+ },
311
+ row: {
312
+ type: 'number',
313
+ description: '行号(从1开始)',
314
+ },
315
+ col: {
316
+ type: 'number',
317
+ description: '列号(从1开始)',
318
+ },
319
+ },
320
+ required: ['sheet', 'row', 'col'],
321
+ },
322
+ category: tools_1.ToolCategory.SPREADSHEET,
323
+ }, async (args) => {
324
+ const sheet = args.sheet;
325
+ const row = args.row;
326
+ const col = args.col;
327
+ const value = await wps_client_1.wpsClient.getCellValue(sheet, row, col);
328
+ return {
329
+ id: '',
330
+ success: true,
331
+ content: [
332
+ {
333
+ type: 'text',
334
+ text: JSON.stringify({ value }),
335
+ },
336
+ ],
337
+ };
338
+ });
339
+ // 设置单元格值
340
+ this.registry.register({
341
+ name: 'wps_set_cell_value',
342
+ description: '设置指定单元格的值',
343
+ inputSchema: {
344
+ type: 'object',
345
+ properties: {
346
+ sheet: {
347
+ type: 'string',
348
+ description: '工作表名称或索引',
349
+ },
350
+ row: {
351
+ type: 'number',
352
+ description: '行号(从1开始)',
353
+ },
354
+ col: {
355
+ type: 'number',
356
+ description: '列号(从1开始)',
357
+ },
358
+ value: {
359
+ type: 'string',
360
+ description: '要设置的值',
361
+ },
362
+ },
363
+ required: ['sheet', 'row', 'col', 'value'],
364
+ },
365
+ category: tools_1.ToolCategory.SPREADSHEET,
366
+ }, async (args) => {
367
+ const sheet = args.sheet;
368
+ const row = args.row;
369
+ const col = args.col;
370
+ const value = args.value;
371
+ const success = await wps_client_1.wpsClient.setCellValue(sheet, row, col, value);
372
+ return {
373
+ id: '',
374
+ success,
375
+ content: [
376
+ {
377
+ type: 'text',
378
+ text: success ? '单元格值设置成功' : '单元格值设置失败',
379
+ },
380
+ ],
381
+ };
382
+ });
383
+ // 获取当前演示文稿信息
384
+ this.registry.register({
385
+ name: 'wps_get_active_presentation',
386
+ description: '获取当前打开的WPS演示文稿信息',
387
+ inputSchema: {
388
+ type: 'object',
389
+ properties: {},
390
+ },
391
+ category: tools_1.ToolCategory.PRESENTATION,
392
+ }, async () => {
393
+ const presentation = await wps_client_1.wpsClient.getActivePresentation();
394
+ return {
395
+ id: '',
396
+ success: presentation !== null,
397
+ content: [
398
+ {
399
+ type: 'text',
400
+ text: presentation
401
+ ? JSON.stringify(presentation)
402
+ : '没有打开的演示文稿',
403
+ },
404
+ ],
405
+ };
406
+ });
407
+ // 执行自定义WPS方法
408
+ this.registry.register({
409
+ name: 'wps_execute_method',
410
+ description: '执行自定义WPS API方法',
411
+ inputSchema: {
412
+ type: 'object',
413
+ properties: {
414
+ method: {
415
+ type: 'string',
416
+ description: 'API方法名',
417
+ },
418
+ params: {
419
+ type: 'object',
420
+ description: '方法参数',
421
+ },
422
+ appType: {
423
+ type: 'string',
424
+ description: '应用类型:wps(文字)、et(表格)、wpp(演示)',
425
+ enum: ['wps', 'et', 'wpp'],
426
+ },
427
+ },
428
+ required: ['method'],
429
+ },
430
+ category: tools_1.ToolCategory.COMMON,
431
+ }, async (args) => {
432
+ const method = args.method;
433
+ const params = args.params;
434
+ const appType = args.appType;
435
+ const response = await wps_client_1.wpsClient.executeMethod(method, params, appType);
436
+ return {
437
+ id: '',
438
+ success: response.success,
439
+ content: [
440
+ {
441
+ type: 'text',
442
+ text: JSON.stringify(response),
443
+ },
444
+ ],
445
+ };
446
+ });
447
+ // ==================== 跨应用数据缓存工具 ====================
448
+ // Excel读取数据 → 缓存到MCP Server → PPT获取缓存 → 创建演示文稿
449
+ // 缓存数据
450
+ this.registry.register({
451
+ name: 'wps_cache_data',
452
+ description: '缓存数据到MCP Server,用于跨应用数据传递。例如:从Excel读取数据后缓存,然后在PPT中使用。',
453
+ inputSchema: {
454
+ type: 'object',
455
+ properties: {
456
+ key: {
457
+ type: 'string',
458
+ description: '缓存键名,用于后续获取数据',
459
+ },
460
+ data: {
461
+ type: 'object',
462
+ description: '要缓存的数据(任意JSON对象)',
463
+ },
464
+ appType: {
465
+ type: 'string',
466
+ description: '数据来源应用类型:et(表格)、wps(文字)、wpp(演示)',
467
+ enum: ['et', 'wps', 'wpp'],
468
+ },
469
+ },
470
+ required: ['key', 'data'],
471
+ },
472
+ category: tools_1.ToolCategory.COMMON,
473
+ }, async (args) => {
474
+ const key = args.key;
475
+ const data = args.data;
476
+ const appType = args.appType || 'unknown';
477
+ WpsMcpServer.dataCache.set(key, {
478
+ data,
479
+ timestamp: Date.now(),
480
+ appType,
481
+ });
482
+ logger.info(`Data cached: key=${key}, appType=${appType}`);
483
+ return {
484
+ id: '',
485
+ success: true,
486
+ content: [
487
+ {
488
+ type: 'text',
489
+ text: JSON.stringify({
490
+ success: true,
491
+ key,
492
+ message: `数据已缓存,可在其他应用中通过 wps_get_cached_data 获取`,
493
+ cacheSize: WpsMcpServer.dataCache.size,
494
+ }),
495
+ },
496
+ ],
497
+ };
498
+ });
499
+ // 获取缓存数据
500
+ this.registry.register({
501
+ name: 'wps_get_cached_data',
502
+ description: '从MCP Server获取缓存的数据,用于跨应用数据传递。',
503
+ inputSchema: {
504
+ type: 'object',
505
+ properties: {
506
+ key: {
507
+ type: 'string',
508
+ description: '缓存键名',
509
+ },
510
+ },
511
+ required: ['key'],
512
+ },
513
+ category: tools_1.ToolCategory.COMMON,
514
+ }, async (args) => {
515
+ const key = args.key;
516
+ const cached = WpsMcpServer.dataCache.get(key);
517
+ if (!cached) {
518
+ return {
519
+ id: '',
520
+ success: false,
521
+ content: [
522
+ {
523
+ type: 'text',
524
+ text: JSON.stringify({
525
+ success: false,
526
+ error: `缓存键 "${key}" 不存在`,
527
+ availableKeys: Array.from(WpsMcpServer.dataCache.keys()),
528
+ }),
529
+ },
530
+ ],
531
+ };
532
+ }
533
+ logger.info(`Cache hit: key=${key}, age=${Date.now() - cached.timestamp}ms`);
534
+ return {
535
+ id: '',
536
+ success: true,
537
+ content: [
538
+ {
539
+ type: 'text',
540
+ text: JSON.stringify({
541
+ success: true,
542
+ key,
543
+ data: cached.data,
544
+ appType: cached.appType,
545
+ cachedAt: new Date(cached.timestamp).toISOString(),
546
+ }),
547
+ },
548
+ ],
549
+ };
550
+ });
551
+ // 列出所有缓存
552
+ this.registry.register({
553
+ name: 'wps_list_cache',
554
+ description: '列出MCP Server中所有缓存的数据键名',
555
+ inputSchema: {
556
+ type: 'object',
557
+ properties: {},
558
+ },
559
+ category: tools_1.ToolCategory.COMMON,
560
+ }, async () => {
561
+ const cacheList = Array.from(WpsMcpServer.dataCache.entries()).map(([key, value]) => ({
562
+ key,
563
+ appType: value.appType,
564
+ cachedAt: new Date(value.timestamp).toISOString(),
565
+ ageMs: Date.now() - value.timestamp,
566
+ }));
567
+ return {
568
+ id: '',
569
+ success: true,
570
+ content: [
571
+ {
572
+ type: 'text',
573
+ text: JSON.stringify({
574
+ success: true,
575
+ count: cacheList.length,
576
+ caches: cacheList,
577
+ }),
578
+ },
579
+ ],
580
+ };
581
+ });
582
+ // 清除缓存
583
+ this.registry.register({
584
+ name: 'wps_clear_cache',
585
+ description: '清除MCP Server中的缓存数据',
586
+ inputSchema: {
587
+ type: 'object',
588
+ properties: {
589
+ key: {
590
+ type: 'string',
591
+ description: '要清除的缓存键名,不指定则清除所有缓存',
592
+ },
593
+ },
594
+ },
595
+ category: tools_1.ToolCategory.COMMON,
596
+ }, async (args) => {
597
+ const key = args.key;
598
+ if (key) {
599
+ const deleted = WpsMcpServer.dataCache.delete(key);
600
+ logger.info(`Cache cleared: key=${key}, deleted=${deleted}`);
601
+ return {
602
+ id: '',
603
+ success: true,
604
+ content: [
605
+ {
606
+ type: 'text',
607
+ text: JSON.stringify({
608
+ success: true,
609
+ message: deleted ? `缓存 "${key}" 已清除` : `缓存 "${key}" 不存在`,
610
+ }),
611
+ },
612
+ ],
613
+ };
614
+ }
615
+ else {
616
+ const count = WpsMcpServer.dataCache.size;
617
+ WpsMcpServer.dataCache.clear();
618
+ logger.info(`All cache cleared: count=${count}`);
619
+ return {
620
+ id: '',
621
+ success: true,
622
+ content: [
623
+ {
624
+ type: 'text',
625
+ text: JSON.stringify({
626
+ success: true,
627
+ message: `已清除所有缓存,共 ${count} 条`,
628
+ }),
629
+ },
630
+ ],
631
+ };
632
+ }
633
+ });
634
+ logger.info(`Registered ${this.registry.size} built-in tools`);
635
+ }
636
+ /**
637
+ * 启动服务器
638
+ */
639
+ async start() {
640
+ if (this.isRunning) {
641
+ logger.warn('Server is already running');
642
+ return;
643
+ }
644
+ logger.info('Starting MCP Server...');
645
+ // 工具已在构造期注册完(registerBuiltinTools + registerAll),
646
+ // 因为 instructions 要在 new Server() 时就带上真实的工具数。
647
+ // 创建stdio传输层
648
+ const transport = new stdio_js_1.StdioServerTransport();
649
+ // 连接传输层
650
+ await this.server.connect(transport);
651
+ // 工具组 load/unload 后通知客户端刷新 tools/list(否则客户端缓存里还是老列表)
652
+ if (!this.groupsNotifyWired) {
653
+ this.groupsNotifyWired = true;
654
+ (0, toolgroups_1.onToolGroupsChanged)(() => {
655
+ void this.notifyToolsChanged();
656
+ });
657
+ }
658
+ this.isRunning = true;
659
+ logger.info('MCP Server started successfully');
660
+ }
661
+ /**
662
+ * 发 notifications/tools/list_changed,让客户端重新拉工具列表。
663
+ * 失败只记日志 —— 通知失败不该影响工具本身的结果。
664
+ */
665
+ async notifyToolsChanged() {
666
+ try {
667
+ await this.server.notification({ method: 'notifications/tools/list_changed' });
668
+ logger.info('已通知客户端工具列表变化', {
669
+ listed: this.registry.listTools().tools.length,
670
+ loadedGroups: this.registry.getLoadedGroups(),
671
+ });
672
+ }
673
+ catch (err) {
674
+ logger.warn('发送 tools/list_changed 通知失败', { error: err.message });
675
+ }
676
+ }
677
+ /**
678
+ * 停止服务器
679
+ */
680
+ async stop() {
681
+ if (!this.isRunning) {
682
+ logger.warn('Server is not running');
683
+ return;
684
+ }
685
+ logger.info('Stopping MCP Server...');
686
+ await this.server.close();
687
+ this.isRunning = false;
688
+ logger.info('MCP Server stopped');
689
+ }
690
+ /**
691
+ * 获取服务器状态
692
+ */
693
+ getStatus() {
694
+ return {
695
+ running: this.isRunning,
696
+ toolCount: this.registry.size,
697
+ };
698
+ }
699
+ }
700
+ exports.WpsMcpServer = WpsMcpServer;
701
+ // 导出单例创建函数
702
+ const createMcpServer = (config) => {
703
+ return new WpsMcpServer(config);
704
+ };
705
+ exports.createMcpServer = createMcpServer;
706
+ exports.default = WpsMcpServer;
707
+ /**
708
+ * 成功但有保留时,在正文前挂一段提示。
709
+ *
710
+ * 为什么必须显式写出来:模型看到 success=true 就会当"全好了",
711
+ * 不说的话它不会去看 warnings —— 而 warnings 里的内容往往正是用户需要知道的
712
+ * ("某个属性没设上""这个锚点插不进去")。宁可啰嗦一点,也不能让用户以为全好。
713
+ */
714
+ function prefixWithWarnings(result) {
715
+ const ws = result.warnings;
716
+ if (!ws || !ws.length)
717
+ return result.content;
718
+ const lines = ws.map((w) => (w.step ? ` - ${w.step}:${w.message}` : ` - ${w.message}`));
719
+ const head = `[部分成功|主操作已完成,${ws.length} 处未按预期]`;
720
+ const hint = '以下是没成功的部分(不要当成全好,也不要重复执行整批)';
721
+ return result.content.map((c, i) => i === 0 && c.type === 'text' && typeof c.text === 'string'
722
+ ? { ...c, text: `${head} ${hint}\n${lines.join('\n')}\n\n${c.text}` }
723
+ : c);
724
+ }
725
+ //# sourceMappingURL=mcp-server.js.map