Leave Management MCP Server

Name: Leave Management MCP Server
Author: ItsMistahJi

@ItsMistahJi

リポジトリ

Leave Management MCP Server について

This is my attempt at creating a leave management mcp server to retrieve details of employees stored in a workbook.

#leave-management #mcp #employee-management

基本情報

カテゴリ

その他

ランタイム

python

トランスポート

stdio

公開者

ItsMistahJi

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "itsmistahji-leave-management-mcp": {
      "command": "uv",
      "args": [
        "init",
        "."
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Leave Management MCP Server?

The Leave Management MCP Server is a Model Context Protocol server for managing employee leave within an organization. It integrates with Excel workbooks containing employee leave data and provides tools for querying and analyzing leave records, designed for use with MCP clients like Claude Desktop.

How to use Leave Management MCP Server?

Install dependences via UV, configure a .env file pointing to your Excel workbook, then run the server locally with uv run python -m src.leave_server or install it into an MCP client using uv run mcp install src/leave_server.py --name "Leave Management". For VS Code, add the provided JSON configuration to your settings.

Key features of Leave Management MCP Server

Integrates with Excel workbooks for leave data storage
Enables natural-language queries about employee leave
Supports queries by employee name, ID, month, or date
Built with Python and uses Pandas for data processing
Can be run locally or installed in MCP clients

Use cases of Leave Management MCP Server

Ask who is on leave today and get instant answers
Check leave balance for a specific employee by ID
List all employees on leave in a given month
Retrieve leave details for a named employee
Query when a particular employee took leave in a specific period

FAQ from Leave Management MCP Server

What does the server do?

It reads an Excel workbook containing employee leave records and exposes MCP tools that allow an AI assistant (e.g., Claude) to answer questions about leave status, balances, and history.

What are the prerequisites?

Python 3.9+, the UV package manager, an MCP client (e.g., Claude Desktop), and an Excel workbook with leave data structured with columns for employee details and monthly leave marks.

Where is the leave data stored?

The data lives in an Excel workbook (e.g., leave_tracker.xlsx) located in a directory specified by the DATA_DIR environment variable. The server expects a sheet named "Leaves-2025" with specific columns.

How do I handle "No module named 'src'" errors?

Ensure __init__.py files exist in src/ and src/models/, add a sys.path modification, or use the provided main.py wrapper in the root directory.

How do I resolve "No module named 'pandas'" errors?

Install all dependencies in the same environment using uv add pandas openpyxl python-dotenv PyPDF2 or use the --with flag when running the server.