Attendance Management

Provides attendance data sources and actions for employee information, attendance, leave, overtime, schedules, and reports.

python

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "shineliang-att-mcp": {
      "command": "./run_mcp.sh",
      "args": [],
      "env": {
        "DB_HOST": "db.weathered-shadow-70756968.us-east-2.aws.neon.tech",
        "DB_NAME": "shinedb",
        "DB_PORT": "5432",
        "DB_USER": "shine_user",
        "DB_PASSWORD": "Shine@123456#!"
      }
    }
  }
}

This MCP Server provides a dedicated interface for attendance information queries and form-based applications. You can manage employee data, track attendance, handle leave and overtime requests, and generate schedules and reports—all through a consistent programmatic API optimized for model-context workflows.

How to use

You interact with this MCP server through an MCP client. Start the server using one of the provided runtime scripts, then issue tool commands to query or modify data. Use the available resources to fetch employee, department, and attendance data, and perform actions like submitting leave or overtime requests, or assigning schedules. You can chain operations to build end-to-end workflows such as approving leave requests after reviewing attendance records.

How to install

Prerequisites: Python 3.10 or higher and Neon PostgreSQL database.

# Step 1: Prepare the project
# Obtain the server sources and navigate to the project root
# (use your preferred method to clone or copy the project files)

# Step 2: Set up a Python virtual environment and install dependencies
./setup_venv.sh

# Step 3: Configure the database connection
# Create a .env file in the project root with the following content
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

# Step 4: Run the MCP server
./run_mcp.sh

# Alternative start via MCP CLI after activating the virtual environment
source .venv/bin/activate
mcp run attendance_mcp_server.py
```,

Additional notes

The server is designed to work in two common approaches: a local runtime via a wrapper script or direct MCP CLI invocation. If you prefer a script-based start, you can execute the run_attendance_mcp script. Ensure the environment variables for the database connection are correctly set in a .env file before starting the server.

Available tools

Employee Information

Manage and query employee data, including personal details and department associations.

Attendance Records

Track and retrieve attendance entries, with options to filter by date ranges and employee.

Leave Management

Submit, review, and approve or reject leave requests.

Overtime Management

Submit, review, and approve or reject overtime requests.

Schedule Management

View, assign, and manage employee schedules and shifts.

Statistics and Reports

Generate monthly attendance statistics and holiday information.

Built by

VeilStrat

AI signals for GTM teams