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 в корне проекта для постоянной диагностики

Это помогает подтвердить, правильно ли запускается MCP-сервер, когда Claude Desktop запускает его.

Проверка

Запустите набор тестов:

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

Проверенный результат:

2 passed in 2.85s

Проект проходит текущие регрессионные тесты, а путь запуска сервера был проверен.