@zcsk/wework-mcp 0.1.0

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.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2024 WeWork MCP Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,201 @@
1
+ # @zcsk/wework-mcp
2
+
3
+ 企业微信 MCP 服务器,支持获取审批功能。
4
+
5
+ ## 快速开始
6
+
7
+ ### 通过 npx 运行(推荐)
8
+
9
+ ```bash
10
+ npx @zcsk/wework-mcp
11
+ ```
12
+
13
+ ### 全局安装
14
+
15
+ ```bash
16
+ npm install -g @zcsk/wework-mcp
17
+ wework-mcp
18
+ ```
19
+
20
+ ### 作为依赖使用
21
+
22
+ ```bash
23
+ npm install @zcsk/wework-mcp
24
+ # 或
25
+ pnpm add @zcsk/wework-mcp
26
+ ```
27
+
28
+ ## 配置
29
+
30
+ 在运行目录创建 `.env` 文件:
31
+
32
+ ```env
33
+ WEWORK_CORP_ID=your_corp_id
34
+ WEWORK_CORP_SECRET=your_corp_secret
35
+ WEWORK_BASE_URL=https://qyapi.weixin.qq.com
36
+ ```
37
+
38
+ 或通过环境变量设置:
39
+
40
+ ```bash
41
+ export WEWORK_CORP_ID=your_corp_id
42
+ export WEWORK_CORP_SECRET=your_corp_secret
43
+ npx @zcsk/wework-mcp
44
+ ```
45
+
46
+ ## 功能特性
47
+
48
+ - ✅ 获取审批模板详情
49
+ - ✅ 获取审批单详情
50
+ - ✅ 获取审批数据列表(支持分页)
51
+ - ✅ Token 自动缓存和刷新
52
+ - ✅ 完整的 TypeScript 类型定义
53
+ - ✅ 基于 Zod 的参数验证
54
+
55
+ ## MCP 工具
56
+
57
+ ### get_approval_template
58
+
59
+ 获取审批模板详情,包括模板的控件结构、字段定义等信息。
60
+
61
+ **参数:**
62
+ - `template_id` (string) - 审批模板 ID
63
+
64
+ **示例:**
65
+ ```json
66
+ {
67
+ "template_id": "3Tka1eD6v6JfzhDMqPd3aMfFdxqWiEhB"
68
+ }
69
+ ```
70
+
71
+ ### get_approval_detail
72
+
73
+ 根据审批单号获取审批申请的详细信息。
74
+
75
+ **参数:**
76
+ - `sp_no` (string) - 审批单号
77
+
78
+ **示例:**
79
+ ```json
80
+ {
81
+ "sp_no": "202401010001"
82
+ }
83
+ ```
84
+
85
+ ### get_approval_list
86
+
87
+ 获取指定时间范围内的审批单列表。
88
+
89
+ **参数:**
90
+ - `start_time` (number) - 开始时间(Unix 时间戳,秒)
91
+ - `end_time` (number) - 结束时间(Unix 时间戳,秒)
92
+ - `cursor` (number, 可选) - 分页游标,首次调用传 0
93
+ - `size` (number, 可选) - 每页数量,默认 100,最大 100
94
+
95
+ **示例:**
96
+ ```json
97
+ {
98
+ "start_time": 1704067200,
99
+ "end_time": 1704153600,
100
+ "cursor": 0,
101
+ "size": 100
102
+ }
103
+ ```
104
+
105
+ ## 编程使用
106
+
107
+ ### 基本使用
108
+
109
+ ```typescript
110
+ import { WeWorkMcpServer } from '@zcsk/wework-mcp';
111
+
112
+ const server = new WeWorkMcpServer('wework-mcp', '0.1.0');
113
+ await server.connectStdio();
114
+ ```
115
+
116
+ ### 自定义传输层
117
+
118
+ ```typescript
119
+ import { WeWorkMcpServer } from '@zcsk/wework-mcp';
120
+ import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
121
+
122
+ const server = new WeWorkMcpServer();
123
+ const transport = new SSEServerTransport('/message', response);
124
+ await server.connect(transport);
125
+ ```
126
+
127
+ ### 访问底层 API
128
+
129
+ ```typescript
130
+ import { getWeWorkClient } from '@zcsk/wework-mcp';
131
+
132
+ const client = getWeWorkClient();
133
+ const template = await client.getTemplateDetail('template_id');
134
+ const detail = await client.getApprovalDetail('sp_no');
135
+ const list = await client.getApprovalList(startTime, endTime);
136
+ ```
137
+
138
+ ## 配置说明
139
+
140
+ | 环境变量 | 说明 | 必需 | 默认值 |
141
+ |---------|------|------|--------|
142
+ | `WEWORK_CORP_ID` | 企业 ID | 是 | - |
143
+ | `WEWORK_CORP_SECRET` | 应用的凭证密钥 | 是 | - |
144
+ | `WEWORK_BASE_URL` | API 基础 URL | 否 | `https://qyapi.weixin.qq.com` |
145
+
146
+ ## 获取企业微信凭证
147
+
148
+ 1. 登录[企业微信管理后台](https://work.weixin.qq.com/)
149
+ 2. 进入「应用管理」
150
+ 3. 选择或创建一个应用
151
+ 4. 获取 `AgentId` 和 `Secret`(即 `WEWORK_CORP_SECRET`)
152
+ 5. 在「企业信息」中获取「企业 ID」(即 `WEWORK_CORP_ID`)
153
+
154
+ ## 在 Claude Desktop 中使用
155
+
156
+ 编辑 Claude Desktop 配置文件:
157
+
158
+ **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
159
+
160
+ **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
161
+
162
+ 添加配置:
163
+
164
+ ```json
165
+ {
166
+ "mcpServers": {
167
+ "wework": {
168
+ "command": "npx",
169
+ "args": ["@zcsk/wework-mcp"],
170
+ "env": {
171
+ "WEWORK_CORP_ID": "your_corp_id",
172
+ "WEWORK_CORP_SECRET": "your_corp_secret"
173
+ }
174
+ }
175
+ }
176
+ }
177
+ ```
178
+
179
+ ## 开发
180
+
181
+ ```bash
182
+ # 克隆仓库
183
+ git clone https://github.com/zcsk/wework-mcp.git
184
+ cd wework-mcp
185
+
186
+ # 安装依赖
187
+ pnpm install
188
+
189
+ # 构建
190
+ pnpm build
191
+
192
+ # 开发模式
193
+ pnpm dev
194
+
195
+ # 运行测试
196
+ pnpm test
197
+ ```
198
+
199
+ ## 许可证
200
+
201
+ MIT
package/dist/cli.d.ts ADDED
@@ -0,0 +1 @@
1
+ #!/usr/bin/env node
package/dist/cli.js ADDED
@@ -0,0 +1,325 @@
1
+ #!/usr/bin/env node
2
+
3
+ // ../shared/dist/base-server.js
4
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
5
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
6
+ var BaseMcpServer = class {
7
+ mcpServer;
8
+ transport;
9
+ config;
10
+ constructor(config) {
11
+ this.config = config;
12
+ this.mcpServer = new McpServer({
13
+ name: config.name,
14
+ version: config.version
15
+ }, {
16
+ capabilities: {
17
+ tools: {}
18
+ }
19
+ });
20
+ this.registerTools();
21
+ }
22
+ /**
23
+ * 注册单个工具
24
+ */
25
+ registerTool(config) {
26
+ this.mcpServer.registerTool(config.name, {
27
+ inputSchema: config.inputSchema,
28
+ description: config.description
29
+ }, config.handler);
30
+ }
31
+ /**
32
+ * 批量注册工具
33
+ */
34
+ registerTools_batch(tools) {
35
+ for (const tool of tools) {
36
+ this.registerTool(tool);
37
+ }
38
+ }
39
+ /**
40
+ * 使用 stdio 传输层连接服务器
41
+ */
42
+ async connectStdio() {
43
+ this.transport = new StdioServerTransport();
44
+ await this.mcpServer.connect(this.transport);
45
+ console.error(`${this.config.name} MCP \u670D\u52A1\u5668\u5DF2\u542F\u52A8`);
46
+ }
47
+ /**
48
+ * 使用自定义传输层连接服务器
49
+ */
50
+ async connect(transport) {
51
+ this.transport = transport;
52
+ await this.mcpServer.connect(transport);
53
+ console.error(`${this.config.name} MCP \u670D\u52A1\u5668\u5DF2\u542F\u52A8`);
54
+ }
55
+ /**
56
+ * 关闭服务器连接
57
+ */
58
+ async close() {
59
+ if (this.transport) {
60
+ await this.mcpServer.close();
61
+ console.error(`${this.config.name} MCP \u670D\u52A1\u5668\u5DF2\u5173\u95ED`);
62
+ }
63
+ }
64
+ /**
65
+ * 获取底层 MCP 服务器实例(用于高级操作)
66
+ */
67
+ getMcpServer() {
68
+ return this.mcpServer;
69
+ }
70
+ /**
71
+ * 获取服务器配置
72
+ */
73
+ getConfig() {
74
+ return this.config;
75
+ }
76
+ };
77
+
78
+ // ../shared/dist/utils.js
79
+ function createTextResponse(text) {
80
+ return {
81
+ content: [
82
+ {
83
+ type: "text",
84
+ text
85
+ }
86
+ ]
87
+ };
88
+ }
89
+ function createJsonResponse(data, pretty = true) {
90
+ return createTextResponse(JSON.stringify(data, null, pretty ? 2 : 0));
91
+ }
92
+
93
+ // src/schemas.ts
94
+ import { z } from "zod";
95
+ var GetApprovalTemplateSchema = z.object({
96
+ template_id: z.string().describe("\u5BA1\u6279\u6A21\u677F ID")
97
+ });
98
+ var GetApprovalDetailSchema = z.object({
99
+ sp_no: z.string().describe("\u5BA1\u6279\u5355\u53F7")
100
+ });
101
+ var GetApprovalListSchema = z.object({
102
+ start_time: z.number().int().positive().describe("\u5F00\u59CB\u65F6\u95F4\uFF08Unix \u65F6\u95F4\u6233\uFF0C\u79D2\uFF09"),
103
+ end_time: z.number().int().positive().describe("\u7ED3\u675F\u65F6\u95F4\uFF08Unix \u65F6\u95F4\u6233\uFF0C\u79D2\uFF09"),
104
+ cursor: z.number().int().nonnegative().optional().describe("\u5206\u9875\u6E38\u6807\uFF0C\u9996\u6B21\u8C03\u7528\u4F20 0"),
105
+ size: z.number().int().positive().max(100).optional().default(100).describe("\u6BCF\u9875\u6570\u91CF\uFF0C\u9ED8\u8BA4 100\uFF0C\u6700\u5927 100")
106
+ });
107
+
108
+ // src/wework-client.ts
109
+ import axios from "axios";
110
+
111
+ // src/config.ts
112
+ import dotenv from "dotenv";
113
+ dotenv.config();
114
+ function getWeWorkConfig() {
115
+ const corpId = process.env.WEWORK_CORP_ID;
116
+ const corpSecret = process.env.WEWORK_CORP_SECRET;
117
+ if (!corpId || !corpSecret) {
118
+ throw new Error("WEWORK_CORP_ID \u548C WEWORK_CORP_SECRET \u73AF\u5883\u53D8\u91CF\u5FC5\u987B\u8BBE\u7F6E");
119
+ }
120
+ return {
121
+ corpId,
122
+ corpSecret,
123
+ baseUrl: process.env.WEWORK_BASE_URL || "https://qyapi.weixin.qq.com"
124
+ };
125
+ }
126
+
127
+ // src/wework-client.ts
128
+ var tokenCache = null;
129
+ var WeWorkClient = class {
130
+ config;
131
+ httpClient;
132
+ constructor() {
133
+ this.config = getWeWorkConfig();
134
+ this.httpClient = axios.create({
135
+ baseURL: this.config.baseUrl,
136
+ timeout: 3e4
137
+ });
138
+ }
139
+ /**
140
+ * 获取 Access Token
141
+ */
142
+ async getAccessToken() {
143
+ const now = Date.now();
144
+ if (tokenCache && now < tokenCache.expiry - 5 * 60 * 1e3) {
145
+ return tokenCache.token;
146
+ }
147
+ try {
148
+ const response = await this.httpClient.get(
149
+ "/cgi-bin/gettoken",
150
+ {
151
+ params: {
152
+ corpid: this.config.corpId,
153
+ corpsecret: this.config.corpSecret
154
+ }
155
+ }
156
+ );
157
+ if (response.data.errcode !== 0) {
158
+ throw new Error(
159
+ `\u83B7\u53D6 Access Token \u5931\u8D25: ${response.data.errmsg} (${response.data.errcode})`
160
+ );
161
+ }
162
+ if (!response.data.access_token || !response.data.expires_in) {
163
+ throw new Error("Access Token \u54CD\u5E94\u683C\u5F0F\u9519\u8BEF");
164
+ }
165
+ tokenCache = {
166
+ token: response.data.access_token,
167
+ expiry: now + response.data.expires_in * 1e3
168
+ };
169
+ return tokenCache.token;
170
+ } catch (error) {
171
+ if (axios.isAxiosError(error)) {
172
+ throw new Error(`\u7F51\u7EDC\u8BF7\u6C42\u5931\u8D25: ${error.message}`);
173
+ }
174
+ throw error;
175
+ }
176
+ }
177
+ /**
178
+ * 调用企业微信 API
179
+ */
180
+ async callApi(method, path, params, data) {
181
+ const token = await this.getAccessToken();
182
+ const requestParams = {
183
+ ...params,
184
+ access_token: token
185
+ };
186
+ try {
187
+ const response = method === "GET" ? await this.httpClient.get(path, {
188
+ params: requestParams
189
+ }) : await this.httpClient.post(path, data, {
190
+ params: requestParams
191
+ });
192
+ if (response.data.errcode !== 0) {
193
+ throw new Error(
194
+ `API \u8C03\u7528\u5931\u8D25: ${response.data.errmsg} (${response.data.errcode})`
195
+ );
196
+ }
197
+ return response.data;
198
+ } catch (error) {
199
+ if (axios.isAxiosError(error)) {
200
+ throw new Error(`\u7F51\u7EDC\u8BF7\u6C42\u5931\u8D25: ${error.message}`);
201
+ }
202
+ throw error;
203
+ }
204
+ }
205
+ /**
206
+ * 获取审批模板详情
207
+ */
208
+ async getTemplateDetail(templateId) {
209
+ const response = await this.callApi("POST", "/cgi-bin/oa/gettemplatedetail", void 0, {
210
+ template_id: templateId
211
+ });
212
+ return {
213
+ template_id: response.template_id || templateId,
214
+ template_name: response.template_name || "",
215
+ template_content: response.template_content
216
+ };
217
+ }
218
+ /**
219
+ * 获取审批申请详情
220
+ */
221
+ async getApprovalDetail(spNo) {
222
+ return await this.callApi(
223
+ "POST",
224
+ "/cgi-bin/oa/getapprovaldetail",
225
+ void 0,
226
+ {
227
+ sp_no: spNo
228
+ }
229
+ );
230
+ }
231
+ /**
232
+ * 获取审批数据
233
+ */
234
+ async getApprovalList(startTime, endTime, cursor, size = 100) {
235
+ const data = {
236
+ starttime: startTime,
237
+ endtime: endTime,
238
+ new_cursor: cursor || "",
239
+ size
240
+ };
241
+ return this.callApi("POST", "/cgi-bin/oa/getapprovalinfo", void 0, data);
242
+ }
243
+ };
244
+ var clientInstance = null;
245
+ function getWeWorkClient() {
246
+ if (!clientInstance) {
247
+ clientInstance = new WeWorkClient();
248
+ }
249
+ return clientInstance;
250
+ }
251
+
252
+ // src/handlers.ts
253
+ async function handleGetApprovalTemplate(args) {
254
+ const client = getWeWorkClient();
255
+ const template = await client.getTemplateDetail(args.template_id);
256
+ return createJsonResponse(template);
257
+ }
258
+ async function handleGetApprovalDetail(args) {
259
+ const client = getWeWorkClient();
260
+ const detail = await client.getApprovalDetail(args.sp_no);
261
+ return createJsonResponse(detail);
262
+ }
263
+ async function handleGetApprovalList(args) {
264
+ const client = getWeWorkClient();
265
+ const data = await client.getApprovalList(
266
+ args.start_time,
267
+ args.end_time,
268
+ args.cursor,
269
+ args.size
270
+ );
271
+ return createJsonResponse(data);
272
+ }
273
+
274
+ // src/server.ts
275
+ var WeWorkMcpServer = class extends BaseMcpServer {
276
+ constructor(name = "wework-mcp", version = "0.1.0") {
277
+ super({ name, version });
278
+ }
279
+ /**
280
+ * 注册所有工具
281
+ */
282
+ registerTools() {
283
+ this.registerTool({
284
+ name: "get_approval_template",
285
+ description: "\u83B7\u53D6\u5BA1\u6279\u6A21\u677F\u8BE6\u60C5\uFF0C\u5305\u62EC\u6A21\u677F\u7684\u63A7\u4EF6\u7ED3\u6784\u3001\u5B57\u6BB5\u5B9A\u4E49\u7B49\u4FE1\u606F",
286
+ inputSchema: GetApprovalTemplateSchema,
287
+ handler: handleGetApprovalTemplate
288
+ });
289
+ this.registerTool({
290
+ name: "get_approval_detail",
291
+ description: "\u6839\u636E\u5BA1\u6279\u5355\u53F7\u83B7\u53D6\u5BA1\u6279\u7533\u8BF7\u7684\u8BE6\u7EC6\u4FE1\u606F\uFF0C\u5305\u62EC\u5BA1\u6279\u72B6\u6001\u3001\u5BA1\u6279\u6D41\u7A0B\u3001\u7533\u8BF7\u4EBA\u4FE1\u606F\u7B49",
292
+ inputSchema: GetApprovalDetailSchema,
293
+ handler: handleGetApprovalDetail
294
+ });
295
+ this.registerTool({
296
+ name: "get_approval_list",
297
+ description: "\u83B7\u53D6\u6307\u5B9A\u65F6\u95F4\u8303\u56F4\u5185\u7684\u5BA1\u6279\u5355\u5217\u8868",
298
+ inputSchema: GetApprovalListSchema,
299
+ handler: handleGetApprovalList
300
+ });
301
+ }
302
+ };
303
+
304
+ // src/cli.ts
305
+ async function main() {
306
+ try {
307
+ const server = new WeWorkMcpServer("wework-mcp", "0.1.0");
308
+ await server.connectStdio();
309
+ process.on("SIGINT", async () => {
310
+ console.error("\n\u6536\u5230\u9000\u51FA\u4FE1\u53F7\uFF0C\u6B63\u5728\u5173\u95ED\u670D\u52A1\u5668...");
311
+ await server.close();
312
+ process.exit(0);
313
+ });
314
+ process.on("SIGTERM", async () => {
315
+ console.error("\n\u6536\u5230\u9000\u51FA\u4FE1\u53F7\uFF0C\u6B63\u5728\u5173\u95ED\u670D\u52A1\u5668...");
316
+ await server.close();
317
+ process.exit(0);
318
+ });
319
+ } catch (error) {
320
+ console.error("\u670D\u52A1\u5668\u542F\u52A8\u5931\u8D25:", error);
321
+ process.exit(1);
322
+ }
323
+ }
324
+ main();
325
+ //# sourceMappingURL=cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../shared/src/base-server.ts","../../shared/src/utils.ts","../src/schemas.ts","../src/wework-client.ts","../src/config.ts","../src/handlers.ts","../src/server.ts","../src/cli.ts"],"sourcesContent":["import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';\nimport type { ServerConfig, ToolConfig } from './types.js';\n\n/**\n * MCP 服务器基类\n * 提供通用的服务器功能和工具注册机制\n */\nexport abstract class BaseMcpServer {\n protected readonly mcpServer: McpServer;\n protected transport?: Transport;\n protected readonly config: ServerConfig;\n\n constructor(config: ServerConfig) {\n this.config = config;\n this.mcpServer = new McpServer(\n {\n name: config.name,\n version: config.version,\n },\n {\n capabilities: {\n tools: {},\n },\n }\n );\n\n // 子类需要实现工具注册\n this.registerTools();\n }\n\n /**\n * 抽象方法:子类需要实现具体的工具注册逻辑\n */\n protected abstract registerTools(): void;\n\n /**\n * 注册单个工具\n */\n protected registerTool<TSchema = any>(config: ToolConfig<TSchema>): void {\n this.mcpServer.registerTool(\n config.name,\n {\n inputSchema: config.inputSchema as any,\n description: config.description,\n },\n config.handler as any\n );\n }\n\n /**\n * 批量注册工具\n */\n protected registerTools_batch(tools: ToolConfig[]): void {\n for (const tool of tools) {\n this.registerTool(tool);\n }\n }\n\n /**\n * 使用 stdio 传输层连接服务器\n */\n async connectStdio(): Promise<void> {\n this.transport = new StdioServerTransport();\n await this.mcpServer.connect(this.transport);\n console.error(`${this.config.name} MCP 服务器已启动`);\n }\n\n /**\n * 使用自定义传输层连接服务器\n */\n async connect(transport: Transport): Promise<void> {\n this.transport = transport;\n await this.mcpServer.connect(transport);\n console.error(`${this.config.name} MCP 服务器已启动`);\n }\n\n /**\n * 关闭服务器连接\n */\n async close(): Promise<void> {\n if (this.transport) {\n await this.mcpServer.close();\n console.error(`${this.config.name} MCP 服务器已关闭`);\n }\n }\n\n /**\n * 获取底层 MCP 服务器实例(用于高级操作)\n */\n getMcpServer(): McpServer {\n return this.mcpServer;\n }\n\n /**\n * 获取服务器配置\n */\n getConfig(): ServerConfig {\n return this.config;\n }\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\n\n/**\n * 创建文本响应\n */\nexport function createTextResponse(text: string): CallToolResult {\n return {\n content: [\n {\n type: 'text' as const,\n text,\n },\n ],\n };\n}\n\n/**\n * 创建 JSON 响应\n */\nexport function createJsonResponse(data: any, pretty: boolean = true): CallToolResult {\n return createTextResponse(JSON.stringify(data, null, pretty ? 2 : 0));\n}\n\n/**\n * 创建错误响应\n */\nexport function createErrorResponse(error: Error | string): CallToolResult {\n const message = typeof error === 'string' ? error : error.message;\n return {\n content: [\n {\n type: 'text' as const,\n text: `错误: ${message}`,\n },\n ],\n isError: true,\n };\n}\n","import { z } from 'zod';\n\n/**\n * 审批模板详情的输入 schema\n */\nexport const GetApprovalTemplateSchema = z.object({\n template_id: z.string().describe('审批模板 ID'),\n});\n\n/**\n * 审批单详情的输入 schema\n */\nexport const GetApprovalDetailSchema = z.object({\n sp_no: z.string().describe('审批单号'),\n});\n\n/**\n * 审批单列表的输入 schema\n */\nexport const GetApprovalListSchema = z.object({\n start_time: z.number().int().positive().describe('开始时间(Unix 时间戳,秒)'),\n end_time: z.number().int().positive().describe('结束时间(Unix 时间戳,秒)'),\n cursor: z.number().int().nonnegative().optional().describe('分页游标,首次调用传 0'),\n size: z.number().int().positive().max(100).optional().default(100).describe('每页数量,默认 100,最大 100'),\n});\n\n/**\n * 类型推断\n */\nexport type GetApprovalTemplateInput = z.infer<typeof GetApprovalTemplateSchema>;\nexport type GetApprovalDetailInput = z.infer<typeof GetApprovalDetailSchema>;\nexport type GetApprovalListInput = z.infer<typeof GetApprovalListSchema>;\n","import axios, { AxiosInstance } from 'axios';\nimport { getWeWorkConfig } from './config.js';\nimport type {\n AccessTokenResponse,\n ApprovalTemplate,\n ApprovalDetail,\n WeWorkApiResponse, ApprovalListResponse,\n} from './types.js';\n\n/**\n * Access Token 缓存\n */\ninterface TokenCache {\n token: string;\n expiry: number;\n}\n\nlet tokenCache: TokenCache | null = null;\n\n/**\n * 清除 token 缓存(主要用于测试)\n */\nexport function clearTokenCache() {\n tokenCache = null;\n}\n\n/**\n * 企业微信 API 客户端\n */\nexport class WeWorkClient {\n private config: ReturnType<typeof getWeWorkConfig>;\n private httpClient: AxiosInstance;\n\n constructor() {\n this.config = getWeWorkConfig();\n this.httpClient = axios.create({\n baseURL: this.config.baseUrl,\n timeout: 30000,\n });\n }\n\n /**\n * 获取 Access Token\n */\n async getAccessToken(): Promise<string> {\n const now = Date.now();\n\n // 检查缓存是否有效(提前 5 分钟刷新)\n if (tokenCache && now < tokenCache.expiry - 5 * 60 * 1000) {\n return tokenCache.token;\n }\n\n try {\n const response = await this.httpClient.get<AccessTokenResponse>(\n '/cgi-bin/gettoken',\n {\n params: {\n corpid: this.config.corpId,\n corpsecret: this.config.corpSecret,\n },\n }\n );\n\n if (response.data.errcode !== 0) {\n throw new Error(\n `获取 Access Token 失败: ${ response.data.errmsg } (${ response.data.errcode })`\n );\n }\n\n if (!response.data.access_token || !response.data.expires_in) {\n throw new Error('Access Token 响应格式错误');\n }\n\n // 缓存 token\n tokenCache = {\n token: response.data.access_token,\n expiry: now + response.data.expires_in * 1000,\n };\n\n return tokenCache.token;\n } catch (error) {\n if (axios.isAxiosError(error)) {\n throw new Error(`网络请求失败: ${ error.message }`);\n }\n throw error;\n }\n }\n\n /**\n * 调用企业微信 API\n */\n private async callApi<T>(\n method: 'GET' | 'POST',\n path: string,\n params?: Record<string, any>,\n data?: any\n ): Promise<T> {\n const token = await this.getAccessToken();\n const requestParams = {\n ...params,\n access_token: token,\n };\n\n try {\n const response =\n method === 'GET'\n ? await this.httpClient.get<WeWorkApiResponse<T>>(path, {\n params: requestParams,\n })\n : await this.httpClient.post<WeWorkApiResponse<T>>(path, data, {\n params: requestParams,\n });\n\n if (response.data.errcode !== 0) {\n throw new Error(\n `API 调用失败: ${ response.data.errmsg } (${ response.data.errcode })`\n );\n }\n\n return response.data as unknown as T;\n } catch (error) {\n if (axios.isAxiosError(error)) {\n throw new Error(`网络请求失败: ${ error.message }`);\n }\n throw error;\n }\n }\n\n /**\n * 获取审批模板详情\n */\n async getTemplateDetail(templateId: string): Promise<ApprovalTemplate> {\n const response = await this.callApi<{\n template_content: ApprovalTemplate['template_content'];\n template_id: string;\n template_name: string;\n }>('POST', '/cgi-bin/oa/gettemplatedetail', undefined, {\n template_id: templateId,\n });\n\n return {\n template_id: response.template_id || templateId,\n template_name: response.template_name || '',\n template_content: response.template_content,\n };\n }\n\n /**\n * 获取审批申请详情\n */\n async getApprovalDetail(spNo: string): Promise<ApprovalDetail> {\n return await this.callApi<ApprovalDetail>(\n 'POST',\n '/cgi-bin/oa/getapprovaldetail',\n undefined,\n {\n sp_no: spNo,\n }\n );\n }\n\n /**\n * 获取审批数据\n */\n async getApprovalList(startTime: number, endTime: number, cursor?: number, size: number = 100): Promise<ApprovalListResponse> {\n const data = {\n starttime: startTime,\n endtime: endTime,\n new_cursor: cursor || '',\n size,\n }\n return this.callApi<ApprovalListResponse>('POST', '/cgi-bin/oa/getapprovalinfo', undefined, data);\n }\n}\n\n// 单例实例\nlet clientInstance: WeWorkClient | null = null;\n\n/**\n * 获取企业微信客户端实例\n */\nexport function getWeWorkClient(): WeWorkClient {\n if (!clientInstance) {\n clientInstance = new WeWorkClient();\n }\n return clientInstance;\n}\n","import dotenv from 'dotenv';\n\ndotenv.config();\n\nexport interface WeWorkConfig {\n corpId: string;\n corpSecret: string;\n baseUrl?: string;\n}\n\nexport function getWeWorkConfig(): WeWorkConfig {\n const corpId = process.env.WEWORK_CORP_ID;\n const corpSecret = process.env.WEWORK_CORP_SECRET;\n\n if (!corpId || !corpSecret) {\n throw new Error('WEWORK_CORP_ID 和 WEWORK_CORP_SECRET 环境变量必须设置');\n }\n\n return {\n corpId,\n corpSecret,\n baseUrl: process.env.WEWORK_BASE_URL || 'https://qyapi.weixin.qq.com',\n };\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { createJsonResponse } from '@zcsk/shared-mcp';\nimport { getWeWorkClient } from './wework-client.js';\nimport type {\n GetApprovalTemplateInput,\n GetApprovalDetailInput,\n GetApprovalListInput,\n} from './schemas.js';\n\n/**\n * 获取审批模板详情处理函数\n */\nexport async function handleGetApprovalTemplate(\n args: GetApprovalTemplateInput\n): Promise<CallToolResult> {\n const client = getWeWorkClient();\n const template = await client.getTemplateDetail(args.template_id);\n return createJsonResponse(template);\n}\n\n/**\n * 获取审批单详情处理函数\n */\nexport async function handleGetApprovalDetail(\n args: GetApprovalDetailInput\n): Promise<CallToolResult> {\n const client = getWeWorkClient();\n const detail = await client.getApprovalDetail(args.sp_no);\n return createJsonResponse(detail);\n}\n\n/**\n * 获取审批单列表处理函数\n */\nexport async function handleGetApprovalList(\n args: GetApprovalListInput\n): Promise<CallToolResult> {\n const client = getWeWorkClient();\n const data = await client.getApprovalList(\n args.start_time,\n args.end_time,\n args.cursor,\n args.size\n );\n return createJsonResponse(data);\n}\n","import { BaseMcpServer } from '@zcsk/shared-mcp';\nimport {\n GetApprovalTemplateSchema,\n GetApprovalDetailSchema,\n GetApprovalListSchema,\n} from './schemas.js';\nimport {\n handleGetApprovalTemplate,\n handleGetApprovalDetail,\n handleGetApprovalList,\n} from './handlers.js';\n\n/**\n * 企业微信 MCP 服务器类\n */\nexport class WeWorkMcpServer extends BaseMcpServer {\n constructor(name: string = 'wework-mcp', version: string = '0.1.0') {\n super({ name, version });\n }\n\n /**\n * 注册所有工具\n */\n protected registerTools(): void {\n // 注册获取审批模板详情工具\n this.registerTool({\n name: 'get_approval_template',\n description: '获取审批模板详情,包括模板的控件结构、字段定义等信息',\n inputSchema: GetApprovalTemplateSchema,\n handler: handleGetApprovalTemplate,\n });\n\n // 注册获取审批单详情工具\n this.registerTool({\n name: 'get_approval_detail',\n description: '根据审批单号获取审批申请的详细信息,包括审批状态、审批流程、申请人信息等',\n inputSchema: GetApprovalDetailSchema,\n handler: handleGetApprovalDetail,\n });\n\n // 注册获取审批单列表工具\n this.registerTool({\n name: 'get_approval_list',\n description: '获取指定时间范围内的审批单列表',\n inputSchema: GetApprovalListSchema,\n handler: handleGetApprovalList,\n });\n }\n}\n","#!/usr/bin/env node\n\nimport { WeWorkMcpServer } from './server.js';\n\n/**\n * CLI 入口文件\n * 支持通过 npx 直接运行\n */\nasync function main() {\n try {\n const server = new WeWorkMcpServer('wework-mcp', '0.1.0');\n await server.connectStdio();\n\n // 处理退出信号\n process.on('SIGINT', async () => {\n console.error('\\n收到退出信号,正在关闭服务器...');\n await server.close();\n process.exit(0);\n });\n\n process.on('SIGTERM', async () => {\n console.error('\\n收到退出信号,正在关闭服务器...');\n await server.close();\n process.exit(0);\n });\n } catch (error) {\n console.error('服务器启动失败:', error);\n process.exit(1);\n }\n}\n\nmain();\n"],"mappings":"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","names":[]}
@@ -0,0 +1,2 @@
1
+
2
+ export { }