Leave Management MCP Server

该项目提供了一个简单的 MCP 服务器，用于一个使用 UV 和 Python 构建的员工休假管理系统。

功能

• 添加员工

• 列出所有员工

• 为员工添加休假记录

• 列出员工的休假记录

• 删除休假记录

• 启动和工具日志，用于故障排查

Related MCP server: leave-manager-mcp-server

项目结构

• src/leave_management_mcp/server.py – MCP 工具定义和内存休假数据存储

• src/leave_management_mcp/__init__.py – 包导出和入口点

• tests/test_leave_management.py – 核心行为的回归测试

• leave_management_mcp.log – 服务器生成的运行时日志文件

本地运行

在项目根目录下：

cd C:\Users\VIJAY\Codebase\mcp\leave-management
uv run leave-management-mcp

该服务器使用 stdio 传输方式，这是 Claude Desktop 推荐的传输方式。

Claude Desktop 配置

创建或编辑此文件：

%APPDATA%\Claude\claude_desktop_config.json

使用以下确切配置：

{
  "mcpServers": {
    "leave-management": {
      "command": "C:\\Users\\VIJAY\\AppData\\Local\\Programs\\Python\\Python314\\Scripts\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\VIJAY\\Codebase\\mcp\\leave-management",
        "run",
        "leave-management-mcp"
      ]
    }
  }
}

重要：

• 之前的路径 C:\Users\VIJAY\.local\bin\uv.exe 在这台机器上无效。

• 实际安装的 UV 路径位于 Python Scripts 文件夹下。

• 保存文件后重启 Claude Desktop。

Claude 中的示例提示

• "添加员工 E001，Alice Johnson"

• "列出所有员工"

• "为 E001 添加从 2026-08-20 到 2026-08-22 的年假"

• "显示 E001 的休假记录"

• "删除 E001 从 2026-08-20 到 2026-08-22 的休假"

日志记录

服务器将日志写入：

• stderr 用于立即输出

• 项目根目录中的 leave_management_mcp.log，用于持久化故障排查

这有助于确认 Claude Desktop 启动时 MCP 服务器是否正确启动。

验证

运行测试套件：

cd C:\Users\VIJAY\Codebase\mcp\leave-management
uv run pytest -q

已验证结果：

2 passed in 2.85s

项目通过了当前的回归测试，并且服务器启动路径已得到验证。