mcp-paike 1.0.0

package/dist/tools/auth.js

@@ -0,0 +1,193 @@
+import open from 'open';
+import { config } from '../config/index.js';
+import { tokenManager } from '../auth/tokenManager.js';
+import { logger } from '../utils/logger.js';
+// Login tool - opens browser and instructs user to paste token
+export const loginTool = {
+    name: 'login',
+    description: '企业微信登录 - 打开浏览器获取访问令牌',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            token: {
+                type: 'string',
+                description: '从网页复制的访问令牌（如果已有令牌，直接提供；否则会打开浏览器）',
+            },
+        },
+        required: [],
+    },
+    handler: async (args) => {
+        // If token is provided, validate and store it
+        if (args.token) {
+            try {
+                logger.info('验证用户提供的 Token');
+                // Validate token by calling /auth/me
+                const user = await validateToken(args.token);
+                // Store credentials with expiry parsed from JWT
+                const expiresIn = parseTokenExpiry(args.token);
+                await tokenManager.storeCredentials({
+                    accessToken: args.token,
+                    issuedAt: Date.now(),
+                    expiresIn,
+                    user,
+                });
+                // Format expiry for display
+                const expiryHours = Math.floor(expiresIn / 3600);
+                const expiryMinutes = Math.floor((expiresIn % 3600) / 60);
+                const expiryText = expiryHours > 0
+                    ? `${expiryHours}小时${expiryMinutes > 0 ? expiryMinutes + '分钟' : ''}`
+                    : `${expiryMinutes}分钟`;
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `登录成功！欢迎回来，${user.realName}\n\n` +
+                                `角色: ${formatRole(user.role)}\n` +
+                                `Token 有效期: ${expiryText}\n\n` +
+                                `现在可以使用其他工具查询数据了。`,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                logger.error('Token 验证失败:', error.message);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Token 验证失败: ${error.message}\n\n请确保 Token 正确且未过期。`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        // No token provided - open browser
+        try {
+            logger.info('打开浏览器进行登录');
+            await open(config.authPageUrl);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `已打开浏览器，请完成以下步骤：\n\n` +
+                            `1. 使用企业微信扫描二维码\n` +
+                            `2. 在手机上确认授权\n` +
+                            `3. 登录成功后复制显示的 Token\n` +
+                            `4. 再次调用 login 工具，并提供 token 参数\n\n` +
+                            `示例: login(token: "eyJhbGc...")`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('打开浏览器失败:', error.message);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `打开浏览器失败: ${error.message}\n\n` +
+                            `请手动访问: ${config.authPageUrl}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+// Get current user tool
+export const getCurrentUserTool = {
+    name: 'get_current_user',
+    description: '获取当前登录用户信息',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+    handler: async () => {
+        const user = tokenManager.getUser();
+        if (!user) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: '未登录，请先调用 login 工具进行企业微信登录',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (!tokenManager.isAuthenticated()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: '登录已过期，请重新调用 login 工具登录',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const loginDuration = tokenManager.getLoginDuration();
+        const timeUntilExpiry = tokenManager.getTimeUntilExpiry();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `当前用户: ${user.realName}\n` +
+                        `用户名: ${user.username}\n` +
+                        `角色: ${formatRole(user.role)}\n` +
+                        `用户ID: ${user.id}\n\n` +
+                        `登录状态: ${loginDuration}\n` +
+                        `Token 状态: ${timeUntilExpiry}`,
+                },
+            ],
+        };
+    },
+};
+// Helper function to validate token
+async function validateToken(token) {
+    // Temporarily set the token for validation
+    const response = await fetch(`${config.apiBaseUrl}/api/auth/me`, {
+        headers: {
+            'Authorization': `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        },
+    });
+    if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw new Error(errorData.message || `验证失败 (${response.status})`);
+    }
+    const result = await response.json();
+    return result.data;
+}
+// Helper function to format role
+function formatRole(role) {
+    const roleMap = {
+        SUPER_ADMIN: '超级管理员',
+        ADMIN: '管理员',
+        STAFF: '员工',
+    };
+    return roleMap[role] || role;
+}
+// Parse token expiry from JWT exp field
+function parseTokenExpiry(token) {
+    try {
+        const payload = token.split('.')[1];
+        if (!payload)
+            return 86400;
+        const decoded = JSON.parse(Buffer.from(payload, 'base64').toString());
+        if (decoded.exp) {
+            // exp is Unix timestamp in seconds
+            const expiresAt = decoded.exp * 1000;
+            const expiresIn = Math.floor((expiresAt - Date.now()) / 1000);
+            return Math.max(expiresIn, 0);
+        }
+    }
+    catch {
+        // Parse failed, use default
+    }
+    return 86400; // Default 24 hours
+}
+export const authTools = [loginTool, getCurrentUserTool];
+//# sourceMappingURL=auth.js.map

package/dist/tools/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/tools/auth.ts"],"names":[],"mappings":"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"}

package/dist/tools/classes.d.ts

@@ -0,0 +1,125 @@
+interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare const listClassesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            search: {
+                type: string;
+                description: string;
+            };
+            status: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            page: {
+                type: string;
+                description: string;
+            };
+            pageSize: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+    handler: (args: {
+        search?: string;
+        status?: string;
+        page?: number;
+        pageSize?: number;
+    }) => Promise<ToolResult>;
+};
+export declare const getClassTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            classId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (args: {
+        classId: string;
+    }) => Promise<ToolResult>;
+};
+export declare const getClassStudentsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            classId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (args: {
+        classId: string;
+    }) => Promise<ToolResult>;
+};
+export declare const classTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            search: {
+                type: string;
+                description: string;
+            };
+            status: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            page: {
+                type: string;
+                description: string;
+            };
+            pageSize: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+    handler: (args: {
+        search?: string;
+        status?: string;
+        page?: number;
+        pageSize?: number;
+    }) => Promise<ToolResult>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            classId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (args: {
+        classId: string;
+    }) => Promise<ToolResult>;
+})[];
+export {};
+//# sourceMappingURL=classes.d.ts.map

package/dist/tools/classes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classes.d.ts","sourceRoot":"","sources":["../../src/tools/classes.ts"],"names":[],"mappings":"AAGA,UAAU,UAAU;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAGD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;oBA0BJ;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KAAG,OAAO,CAAC,UAAU,CAAC;CAmDxB,CAAC;AAGF,eAAO,MAAM,YAAY;;;;;;;;;;;;;oBAaD;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;CAgChE,CAAC;AAGF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;oBAaT;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;CAkChE,CAAC;AA2BF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;oBArLC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KAAG,OAAO,CAAC,UAAU,CAAC;;;;;;;;;;;;;;oBAmED;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;IAiHhE,CAAC"}

package/dist/tools/classes.js

@@ -0,0 +1,195 @@
+import { apiClient } from '../api/client.js';
+import { logger } from '../utils/logger.js';
+// List classes
+export const listClassesTool = {
+    name: 'list_classes',
+    description: '查询班级列表，支持按名称搜索、状态筛选',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            search: {
+                type: 'string',
+                description: '班级名称或编号搜索关键词',
+            },
+            status: {
+                type: 'string',
+                enum: ['ACTIVE', 'PAUSED', 'GRADUATED', 'DELETED'],
+                description: '班级状态筛选: ACTIVE(进行中), PAUSED(暂停), GRADUATED(已结业), DELETED(已删除)',
+            },
+            page: {
+                type: 'number',
+                description: '页码，默认1',
+            },
+            pageSize: {
+                type: 'number',
+                description: '每页数量，默认20',
+            },
+        },
+        required: [],
+    },
+    handler: async (args) => {
+        try {
+            logger.debug('查询班级列表', args);
+            const params = {};
+            if (args.search)
+                params.search = args.search;
+            if (args.status)
+                params.status = args.status;
+            const result = await apiClient.get('/api/classes', params);
+            if (!result || result.length === 0) {
+                return {
+                    content: [{ type: 'text', text: '暂无班级数据' }],
+                };
+            }
+            const classes = result.map((c) => ({
+                id: c.id,
+                name: c.name,
+                classNumber: c.classNumber,
+                status: formatStatus(c.status),
+                course: c.course?.name,
+                teacher: c.primaryTeacher?.realName,
+                classroom: c.primaryClassroom?.name,
+                studentCount: c._count?.classStudents || 0,
+            }));
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `查询结果: 共 ${classes.length} 个班级\n\n` +
+                            classes.map((c, index) => `${index + 1}. ${c.name} [ID: ${c.id}]\n` +
+                                `   班号: ${c.classNumber} | 状态: ${c.status}\n` +
+                                `   课程: ${c.course || '-'}\n` +
+                                `   教师: ${c.teacher || '-'} | 教室: ${c.classroom || '-'}\n` +
+                                `   学员数: ${c.studentCount}`).join('\n\n'),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('查询班级列表失败:', error.message);
+            return {
+                content: [{ type: 'text', text: `查询失败: ${error.message}` }],
+                isError: true,
+            };
+        }
+    },
+};
+// Get class detail
+export const getClassTool = {
+    name: 'get_class',
+    description: '获取班级详细信息',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            classId: {
+                type: 'string',
+                description: '班级ID',
+            },
+        },
+        required: ['classId'],
+    },
+    handler: async (args) => {
+        try {
+            logger.debug('获取班级详情', args);
+            const cls = await apiClient.get(`/api/classes/${args.classId}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `班级详情:\n\n` +
+                            `名称: ${cls.name}\n` +
+                            `编号: ${cls.classNumber}\n` +
+                            `状态: ${formatStatus(cls.status)}\n` +
+                            `课程: ${cls.course?.name || '-'}\n` +
+                            `课程类别: ${cls.course?.category?.name || '-'}\n\n` +
+                            `主讲教师: ${cls.primaryTeacher?.realName || '-'}\n` +
+                            `教室: ${cls.classroom?.name || '-'}\n\n` +
+                            `学员数: ${cls._count?.classStudents || 0}\n` +
+                            `已排课时数: ${cls._count?.courseSessions || 0}\n\n` +
+                            (cls.notes ? `备注: ${cls.notes}\n` : ''),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('获取班级详情失败:', error.message);
+            return {
+                content: [{ type: 'text', text: `查询失败: ${error.message}` }],
+                isError: true,
+            };
+        }
+    },
+};
+// Get class students
+export const getClassStudentsTool = {
+    name: 'get_class_students',
+    description: '获取班级学员名单',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            classId: {
+                type: 'string',
+                description: '班级ID',
+            },
+        },
+        required: ['classId'],
+    },
+    handler: async (args) => {
+        try {
+            logger.debug('获取班级学员', args);
+            const students = await apiClient.get(`/api/classes/${args.classId}/students`);
+            if (!students || students.length === 0) {
+                return {
+                    content: [{ type: 'text', text: '该班级暂无学员' }],
+                };
+            }
+            const formatted = students.map((s, index) => `${index + 1}. ${s.student?.name || '未知'}\n` +
+                `   状态: ${formatStudentStatus(s.student?.status)} | 类型: ${s.student?.studentType === 'FORMAL' ? '正式' : '意向'}\n` +
+                `   加入时间: ${formatDate(s.joinedAt)}`).join('\n\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `班级学员名单 (共 ${students.length} 人):\n\n${formatted}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('获取班级学员失败:', error.message);
+            return {
+                content: [{ type: 'text', text: `查询失败: ${error.message}` }],
+                isError: true,
+            };
+        }
+    },
+};
+// Helper functions
+function formatStatus(status) {
+    const statusMap = {
+        ACTIVE: '进行中',
+        PAUSED: '暂停',
+        GRADUATED: '已结业',
+        DELETED: '已删除',
+    };
+    return statusMap[status] || status;
+}
+function formatStudentStatus(status) {
+    const statusMap = {
+        ACTIVE: '学习中',
+        PAUSED: '暂停',
+        GRADUATED: '毕业',
+    };
+    return statusMap[status] || status;
+}
+function formatDate(dateStr) {
+    if (!dateStr)
+        return '-';
+    return new Date(dateStr).toLocaleDateString('zh-CN');
+}
+export const classTools = [
+    listClassesTool,
+    getClassTool,
+    getClassStudentsTool,
+];
+//# sourceMappingURL=classes.js.map

package/dist/tools/classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classes.js","sourceRoot":"","sources":["../../src/tools/classes.ts"],"names":[],"mappings":"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"}

package/dist/tools/finance.d.ts

@@ -0,0 +1,152 @@
+interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Query teacher sales and session fees by date range
+ *
+ * Access Control:
+ * - STAFF: Can only query their own data
+ * - ADMIN/SUPER_ADMIN: Can query any teacher's data
+ *
+ * @returns Formatted report with:
+ * - Total sessions count
+ * - Total sales amount (课销)
+ * - Total session fees (课次费)
+ * - Session-by-session breakdown
+ */
+export declare const getTeacherSalesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            startDate: {
+                type: string;
+                description: string;
+            };
+            endDate: {
+                type: string;
+                description: string;
+            };
+            teacherId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (args: {
+        startDate: string;
+        endDate: string;
+        teacherId?: string;
+    }) => Promise<ToolResult>;
+};
+/**
+ * Query student session balance details
+ *
+ * Access Control:
+ * - All authenticated users can query
+ *
+ * @returns Student info with:
+ * - Name, status, type
+ * - Balance per course category
+ * - Used vs total sessions breakdown
+ */
+export declare const getStudentBalanceDetailTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            studentId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (args: {
+        studentId: string;
+    }) => Promise<ToolResult>;
+};
+/**
+ * Query session fee rules for all course categories
+ *
+ * Access Control:
+ * - ADMIN/SUPER_ADMIN only (requiredRole: 'ADMIN')
+ *
+ * @returns List of fee rules organized by category:
+ * - Category name
+ * - Student count ranges (min-max)
+ * - Session rate per student count tier
+ */
+export declare const getSessionFeeRulesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+    requiredRole: "ADMIN";
+    handler: () => Promise<ToolResult>;
+};
+export declare const financeTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            startDate: {
+                type: string;
+                description: string;
+            };
+            endDate: {
+                type: string;
+                description: string;
+            };
+            teacherId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (args: {
+        startDate: string;
+        endDate: string;
+        teacherId?: string;
+    }) => Promise<ToolResult>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            studentId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (args: {
+        studentId: string;
+    }) => Promise<ToolResult>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+    requiredRole: "ADMIN";
+    handler: () => Promise<ToolResult>;
+})[];
+export {};
+//# sourceMappingURL=finance.d.ts.map