Leavemanagementmcp

🚀 請假管理MCP服務器

本項目提供了一個名為LeaveManagementSystem的模型上下文協議（MCP）服務器。它能讓諸如Cursor或Claude等AI助手扮演人力資源協同助手的角色，負責收集請假詳情、驗證請假政策、即時批准請假申請，併發送人性化的確認信息。該服務器使用Python和fastmcp實現，具有輕量級、有狀態且易於擴展的特點。

🚀 快速開始

1. 安裝依賴項（使用uv確保環境的確定性）：

   uv pip install -r pyproject.toml
   

2. 手動運行MCP服務器（可選）：

   uv run --with mcp[cli] mcp run main.py
   

3. 在MCP客戶端（Cursor或Claude）中註冊服務器。使用以下命令：

   C:\Users\Asus\.local\bin\uv.EXE run --with mcp[cli] mcp run C:\Users\Asus\Desktop\leavemanagementMCP\main.py
   

4. 重啟客戶端以加載新服務器。

✨ 主要特性

解決的問題

• 手動請假流程效率低下：人力資源團隊需要花費大量時間收集員工信息、驗證請假政策以及撰寫批准郵件。
• AI助手常缺失關鍵上下文：典型的AI自動化在觸發工具時，無法確保獲取所有必要的詳細信息，從而導致錯誤或反覆澄清。
• 批准過程需要可審計的記錄：管理人員希望瞭解是誰申請了請假、已請假天數以及批准請假的原因。

解決方案亮點

• 結構化的MCP工具：apply_leave、approve_leave、reject_leave和leave - status資源將所有核心人力資源操作以確定性的API形式暴露出來。
• 內置防護機制：工具驗證確保AI助手在採取行動前收集到employee_id、days和具體的reason。
• 自動批准工作流：當調用apply_leave時，系統會自動批准申請、更新剩餘假期天數，並模擬發送郵件通知。Claude（或任何支持MCP的助手）可以立即響應，無需等待人工管理人員。
• 即時狀態跟蹤：AI助手可以查詢leave - status://{emp_id}，向員工共享當前剩餘假期天數和審批歷史。

技術先進性

• 以AI助手為優先的設計：我們提供的是專門為大語言模型（LLM）工具平臺定製的原生MCP服務器，而不是簡單的REST API。Claude、Cursor和未來的MCP客戶端可以發現服務器的功能、執行參數約定，並以最少的粘合代碼編排高級流程。
• 保障AI代理的操作安全：服務器端強制執行驗證、政策限制和審計跟蹤，使得讓自主代理批准請假更加安全。
• 可組合的人力資源自動化：由於所有操作都在MCP服務器內運行，你可以將此服務器與其他MCP服務（如日曆同步、薪資計算、分析等）進行鏈式組合，而無需定製集成。
• 支持即時協作：內存模型在會話期間保持狀態，遷移到數據庫或SaaS後端就像更換存儲層一樣簡單。

📦 安裝指南

核心技術

• Python 3.11+：具有類型提示的現代Python版本，有助於進行健壯的開發。
• FastMCP：高性能的MCP服務器框架，可與支持MCP的客戶端實現無縫集成。
• 模型上下文協議（MCP）：AI助手與外部工具和資源交互的標準化協議。
• uv：快速的Python包安裝器和依賴項管理器，可確保環境的可重複性。

數據層

• 當前實現：使用內存數據結構（字典和列表）進行快速原型開發。
• 生產環境準備：設計支持數據庫抽象，可以無縫連接到以下數據庫：
  • SQLite：輕量級、基於文件的數據庫，適用於中小型部署。
  • PostgreSQL：企業級關係型數據庫，適用於生產環境。
  • MySQL/MariaDB：可選的關係型數據庫。
  • MongoDB：支持靈活文檔存儲的NoSQL數據庫。
  • SaaS HRIS API：可直接與現有的人力資源管理系統（如Workday、BambooHR等）集成。

集成點

• MCP客戶端：原生支持Claude Desktop、Cursor IDE和其他支持MCP的客戶端。
• 郵件通知：模擬郵件系統，可與SendGrid、AWS SES、SMTP服務器集成。
• 未來擴展：支持日曆API、Slack/Teams Webhook、薪資系統。

開發工具

• pyproject.toml：現代Python項目配置文件，用於管理依賴項。
• uv.lock：鎖定依賴項版本，確保構建的可重複性。

💻 使用示例

基礎用法

• 申請請假：收集emp_id、days和reason。工具會自動批准申請，並返回格式化的確認信息和模擬的郵件通知。
• 手動調整審批結果：如有需要，可手動調用approve_leave或reject_leave來調整請假狀態。
• 查詢請假狀態：查詢leave - status://emp001（可替換為任何員工ID），查看剩餘假期天數和審批歷史。

高級用法

數據庫集成

系統架構支持直接連接數據庫。你可以用數據庫查詢替換內存數據結構：

# Replace in-memory dictionaries with database queries
employees = db.query("SELECT emp_id, name, leaves_taken FROM employees")
leave_requests = db.query("SELECT * FROM leave_requests WHERE emp_id = ?", [emp_id])

系統擴展

• 數據庫集成：系統支持直接連接數據庫，你可以將內存數據結構替換為數據庫查詢：
  • SQLite：適用於小團隊，單文件數據庫，無需配置。
  • PostgreSQL/MySQL：企業級數據庫，支持ACID特性、事務和複雜查詢。
  • MongoDB：基於文檔的存儲方式，支持靈活的模式演變。
  • HRIS API：通過REST/GraphQL API直接連接現有的人力資源系統（如Workday、BambooHR、ADP）。
• 附加增強功能：
  • 身份驗證與授權：添加基於角色的訪問控制（RBAC），限制批准/拒絕請假的人員權限。
  • 真實郵件/SMS集成：連接到事務性郵件提供商（如SendGrid、AWS SES）或SMS網關（如Twilio）。
  • 分析與報告：暴露MCP資源，提供年度總結、團隊請假日曆和政策合規報告。
  • Webhook支持：當請假被批准/拒絕時，觸發外部系統。
  • 多租戶支持：對於SaaS部署，按組織/公司隔離數據。