考勤管理 MCP 服务器

这是一个用于考勤信息查询和表单申请的模型上下文协议 (MCP) 服务器。它提供了用于管理员工考勤、请假申请、加班申请和日程安排的工具和资源。

功能特性

• 员工信息管理
• 考勤记录跟踪
• 请假申请管理
• 加班申请管理
• 日程安排管理
• 统计和报告

前提条件

• Python 3.10 或更高版本
• Neon PostgreSQL 数据库

安装

1. 克隆此仓库：

   git clone https://github.com/yourusername/attendance-mcp-server.git
   cd attendance-mcp-server
   

2. 设置虚拟环境并安装所需的依赖项：

   ./setup_venv.sh
   

3. 通过创建包含以下内容的 .env 文件来配置数据库连接：

   DB_HOST=db.weathered-shadow-70756968.us-east-2.aws.neon.tech
   DB_NAME=shinedb
   DB_USER=shine_user
   DB_PASSWORD=Shine@123456#!
   DB_PORT=5432
   

运行服务器

您可以使用包装脚本运行服务器：

./run_mcp.sh

或者激活虚拟环境并使用 MCP CLI：

source .venv/bin/activate
mcp run attendance_mcp_server.py

与 Claude Desktop 一起使用

要将此服务器与 Claude Desktop 一起使用：

1. 从 claude.ai/download 安装 Claude Desktop

2. 运行安装脚本以配置 Claude Desktop：

   python install_claude_desktop.py
   

3. 重启 Claude Desktop

故障排除

如果您遇到 "No module named 'mcp'" 错误：

1. 确保 MCP 包已安装在 Claude Desktop 正在使用的 Python 环境中：

   ./install_dependencies.sh
   

2. 检查 Claude Desktop 日志以获取更多信息：

   • 在 macOS 上：~/Library/Logs/Claude/mcp*.log
   • 在 Windows 上：%APPDATA%\Claude\Logs\mcp*.log

3. 如果问题仍然存在，请尝试手动运行 MCP 服务器以查看是否存在任何错误：

   ./run_attendance_mcp.sh
   

可用工具

员工信息

• get_employee_info: 按 ID 或员工编号获取员工信息
• list_employees: 列出员工，可选择过滤
• list_departments: 列出所有部门

考勤记录

• get_attendance_records: 获取考勤记录，可选择过滤
• submit_attendance_record: 提交新的考勤记录或更新现有记录

请假管理

• get_leave_requests: 获取请假申请，可选择过滤
• submit_leave_request: 提交新的请假申请
• approve_leave_request: 批准或拒绝请假申请

加班管理

• get_overtime_requests: 获取加班申请，可选择过滤
• submit_overtime_request: 提交新的加班申请
• approve_overtime_request: 批准或拒绝加班申请

日程安排管理

• get_employee_schedule: 获取员工日程安排，可选择过滤
• list_shifts: 列出所有可用的班次
• assign_schedule: 为员工分配日程安排

统计和报告

• get_monthly_attendance_stats: 获取每月考勤统计信息
• get_holidays: 获取节假日，可选择过滤

可用资源

• employee://{employee_id}: 获取员工信息作为资源
• department://{department_id}: 获取部门信息作为资源
• attendance://{employee_id}/{date}: 获取特定员工和日期的考勤信息

可用提示词

• request_leave: 创建请假申请提示词
• request_overtime: 创建加班申请提示词
• check_attendance: 创建考勤检查提示词

许可证

MIT