mcp-paike 1.0.0

package/dist/index.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { config, validateConfig } from './config/index.js';
+import { toolRegistry } from './tools/index.js';
+import { tokenManager } from './auth/tokenManager.js';
+import { logger } from './utils/logger.js';
+// Validate configuration
+validateConfig();
+// Create MCP server
+const server = new Server({
+    name: 'mcp-paike',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List available tools - with role-based filtering
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    // Initialize token manager to get user info
+    await tokenManager.init();
+    // Get user role (null if not authenticated)
+    const userRole = tokenManager.getUserRole();
+    // Filter tools based on user role
+    const availableTools = tokenManager.isAuthenticated()
+        ? toolRegistry.getToolsForRole(userRole)
+        : toolRegistry.getAllTools(); // Show all tools if not logged in (for discovery)
+    const tools = availableTools.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+    }));
+    logger.debug(`列出 ${tools.length} 个可用工具 (角色: ${userRole || '未登录'})`);
+    return { tools };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    logger.info(`调用工具: ${name}`);
+    logger.debug('工具参数:', args);
+    // Check authentication for non-login tools
+    if (name !== 'login' && name !== 'get_current_user') {
+        // Initialize token manager if needed
+        await tokenManager.init();
+        if (!tokenManager.isAuthenticated()) {
+            logger.warn('用户未登录，拒绝工具调用');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: '未登录，请先调用 login 工具进行企业微信登录。\n\n' +
+                            '使用方法:\n' +
+                            '1. 调用 login 工具（无参数）打开浏览器\n' +
+                            '2. 扫码登录后复制 Token\n' +
+                            '3. 再次调用 login 工具并提供 token 参数',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Warn if token is expiring soon
+        if (tokenManager.isTokenExpiringSoon()) {
+            const timeLeft = tokenManager.getTimeUntilExpiry();
+            logger.warn(`Token 即将过期: ${timeLeft}`);
+        }
+    }
+    // Get tool
+    const tool = toolRegistry.getTool(name);
+    if (!tool) {
+        logger.error(`未知工具: ${name}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `未知工具: ${name}\n\n可用工具: ${toolRegistry.getToolNames().join(', ')}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Check role requirement (double protection)
+    if (tool.requiredRole) {
+        const userRole = tokenManager.getUserRole();
+        const isAdmin = userRole === 'ADMIN' || userRole === 'SUPER_ADMIN';
+        if (tool.requiredRole === 'ADMIN' && !isAdmin) {
+            const roleMap = {
+                SUPER_ADMIN: '超级管理员',
+                ADMIN: '管理员',
+                STAFF: '员工',
+            };
+            logger.warn('用户权限不足，拒绝工具调用', { tool: name, userRole });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: '权限不足：此工具需要管理员权限。\n\n' +
+                            `当前角色: ${roleMap[userRole || ''] || '未知'}\n` +
+                            '请联系管理员获取访问权限。',
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    // Initialize token manager for auth tools too
+    if (name === 'login' || name === 'get_current_user') {
+        await tokenManager.init();
+    }
+    // Execute tool
+    try {
+        const result = await tool.handler(args || {});
+        logger.debug(`工具 ${name} 执行完成`);
+        return result;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`工具 ${name} 执行失败:`, errorMessage);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `工具执行失败: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    logger.info('MCP Paike Server 启动中...');
+    logger.info(`API 地址: ${config.apiBaseUrl}`);
+    logger.info(`认证页面: ${config.authPageUrl}`);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info('MCP Paike Server 已启动');
+}
+main().catch((error) => {
+    logger.error('服务器启动失败:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/attendances.d.ts

@@ -0,0 +1,145 @@
+interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare const listAttendancesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            sessionId: {
+                type: string;
+                description: string;
+            };
+            studentId: {
+                type: string;
+                description: string;
+            };
+            startDate: {
+                type: string;
+                description: string;
+            };
+            endDate: {
+                type: string;
+                description: string;
+            };
+            page: {
+                type: string;
+                description: string;
+            };
+            pageSize: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+    handler: (args: {
+        sessionId?: string;
+        studentId?: string;
+        startDate?: string;
+        endDate?: string;
+        page?: number;
+        pageSize?: number;
+    }) => Promise<ToolResult>;
+};
+export declare const getAttendanceTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            attendanceId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (args: {
+        attendanceId: string;
+    }) => Promise<ToolResult>;
+};
+export declare const listTeachersTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+    handler: () => Promise<ToolResult>;
+};
+export declare const attendanceTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            sessionId: {
+                type: string;
+                description: string;
+            };
+            studentId: {
+                type: string;
+                description: string;
+            };
+            startDate: {
+                type: string;
+                description: string;
+            };
+            endDate: {
+                type: string;
+                description: string;
+            };
+            page: {
+                type: string;
+                description: string;
+            };
+            pageSize: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+    handler: (args: {
+        sessionId?: string;
+        studentId?: string;
+        startDate?: string;
+        endDate?: string;
+        page?: number;
+        pageSize?: number;
+    }) => Promise<ToolResult>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            attendanceId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (args: {
+        attendanceId: string;
+    }) => Promise<ToolResult>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+    handler: () => Promise<ToolResult>;
+})[];
+export {};
+//# sourceMappingURL=attendances.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attendances.d.ts","sourceRoot":"","sources":["../../src/tools/attendances.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,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAiCR;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KAAG,OAAO,CAAC,UAAU,CAAC;CAsDxB,CAAC;AAGF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;oBAaN;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;CA+BrE,CAAC;AAGF,eAAO,MAAM,gBAAgB;;;;;;;;mBAQR,OAAO,CAAC,UAAU,CAAC;CAkCvC,CAAC;AAiCF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA1LJ;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KAAG,OAAO,CAAC,UAAU,CAAC;;;;;;;;;;;;;;oBAsED;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;;;;;;;;;mBA0CjD,OAAO,CAAC,UAAU,CAAC;IAuEvC,CAAC"}

package/dist/tools/attendances.js

@@ -0,0 +1,202 @@
+import { apiClient } from '../api/client.js';
+import { logger } from '../utils/logger.js';
+// List attendances
+export const listAttendancesTool = {
+    name: 'list_attendances',
+    description: '查询考勤记录，支持按课程、学员、日期筛选',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            sessionId: {
+                type: 'string',
+                description: '课程ID',
+            },
+            studentId: {
+                type: 'string',
+                description: '学员ID',
+            },
+            startDate: {
+                type: 'string',
+                description: '开始日期 (YYYY-MM-DD)',
+            },
+            endDate: {
+                type: 'string',
+                description: '结束日期 (YYYY-MM-DD)',
+            },
+            page: {
+                type: 'number',
+                description: '页码，默认1',
+            },
+            pageSize: {
+                type: 'number',
+                description: '每页数量，默认20',
+            },
+        },
+        required: [],
+    },
+    handler: async (args) => {
+        try {
+            logger.debug('查询考勤记录', args);
+            // Validate and limit pagination parameters
+            const params = {
+                page: Math.max(1, args.page || 1),
+                pageSize: Math.min(100, Math.max(1, args.pageSize || 20)),
+            };
+            if (args.sessionId)
+                params.sessionId = args.sessionId;
+            if (args.studentId)
+                params.studentId = args.studentId;
+            if (args.startDate)
+                params.startDate = args.startDate;
+            if (args.endDate)
+                params.endDate = args.endDate;
+            const result = await apiClient.get('/api/attendances', params);
+            const attendances = result.items.map((a) => ({
+                id: a.id,
+                studentName: a.student?.name,
+                sessionTime: formatDateTime(a.session?.startTime),
+                className: a.session?.class?.name || '临时课程',
+                status: formatStatus(a.status),
+                sessionsDeducted: a.sessionsDeducted,
+                deductionType: formatDeductionType(a.deductionType),
+            }));
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `查询结果: 共 ${result.total} 条记录 (第 ${result.page}/${result.totalPages} 页)\n\n` +
+                            attendances.map((a, index) => `${index + 1}. ${a.studentName} | ${a.sessionTime} [ID: ${a.id}]\n` +
+                                `   班级: ${a.className}\n` +
+                                `   状态: ${a.status} | 扣课: ${a.sessionsDeducted}节 (${a.deductionType})`).join('\n\n'),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('查询考勤记录失败:', error.message);
+            return {
+                content: [{ type: 'text', text: `查询失败: ${error.message}` }],
+                isError: true,
+            };
+        }
+    },
+};
+// Get attendance detail
+export const getAttendanceTool = {
+    name: 'get_attendance',
+    description: '获取考勤详情',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            attendanceId: {
+                type: 'string',
+                description: '考勤记录ID',
+            },
+        },
+        required: ['attendanceId'],
+    },
+    handler: async (args) => {
+        try {
+            logger.debug('获取考勤详情', args);
+            const attendance = await apiClient.get(`/api/attendances/${args.attendanceId}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `考勤详情:\n\n` +
+                            `学员: ${attendance.student?.name || '-'}\n` +
+                            `课程时间: ${formatDateTime(attendance.session?.startTime)}\n` +
+                            `班级: ${attendance.session?.class?.name || '临时课程'}\n` +
+                            `教师: ${attendance.session?.teacher?.realName || '-'}\n\n` +
+                            `考勤状态: ${formatStatus(attendance.status)}\n` +
+                            `扣课数: ${attendance.sessionsDeducted} 节\n` +
+                            `扣课类型: ${formatDeductionType(attendance.deductionType)}\n\n` +
+                            (attendance.notes ? `备注: ${attendance.notes}\n` : '') +
+                            `记录时间: ${formatDateTime(attendance.createdAt)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('获取考勤详情失败:', error.message);
+            return {
+                content: [{ type: 'text', text: `查询失败: ${error.message}` }],
+                isError: true,
+            };
+        }
+    },
+};
+// List teachers
+export const listTeachersTool = {
+    name: 'list_teachers',
+    description: '获取教师列表',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+    handler: async () => {
+        try {
+            logger.debug('获取教师列表');
+            const teachers = await apiClient.get('/api/staff-accounts/teaching-staff');
+            if (!teachers || teachers.length === 0) {
+                return {
+                    content: [{ type: 'text', text: '暂无可用教师' }],
+                };
+            }
+            const formatted = teachers.map((t, index) => `${index + 1}. ${t.realName} [ID: ${t.id}]\n` +
+                `   用户名: ${t.username}\n` +
+                `   部门: ${t.department || '-'}`).join('\n\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `教师列表 (共 ${teachers.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 = {
+        PRESENT: '出勤',
+        ABSENT: '缺勤',
+        LEAVE: '请假',
+    };
+    return statusMap[status] || status;
+}
+function formatDeductionType(type) {
+    const typeMap = {
+        PURCHASED: '购买课次',
+        BONUS: '赠送课次',
+        NONE: '不扣课',
+    };
+    return typeMap[type] || type;
+}
+function formatDateTime(dateStr) {
+    if (!dateStr)
+        return '-';
+    const date = new Date(dateStr);
+    return date.toLocaleString('zh-CN', {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+    });
+}
+export const attendanceTools = [
+    listAttendancesTool,
+    getAttendanceTool,
+    listTeachersTool,
+];
+//# sourceMappingURL=attendances.js.map

package/dist/tools/attendances.js.map

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

package/dist/tools/auth.d.ts

@@ -0,0 +1,62 @@
+interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare const loginTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            token: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+    handler: (args: {
+        token?: string;
+    }) => Promise<ToolResult>;
+};
+export declare const getCurrentUserTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+    handler: () => Promise<ToolResult>;
+};
+export declare const authTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            token: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+    handler: (args: {
+        token?: string;
+    }) => Promise<ToolResult>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+    handler: () => Promise<ToolResult>;
+})[];
+export {};
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/tools/auth.ts"],"names":[],"mappings":"AAMA,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,SAAS;;;;;;;;;;;;;oBAaE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;CAkF/D,CAAC;AAGF,eAAO,MAAM,kBAAkB;;;;;;;;mBAQV,OAAO,CAAC,UAAU,CAAC;CA4CvC,CAAC;AAkDF,eAAO,MAAM,SAAS;;;;;;;;;;;;;oBA3LE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;;;;;;;;;mBA6F3C,OAAO,CAAC,UAAU,CAAC;IA8FgB,CAAC"}