Custom MCP server for UOF X Total Solution - provides tools for BPM forms, attendance tracking, organization management, document management, notifications, and agent settings
24 tools with consistent naming (verb_noun pattern: get_, set_, delete_, search_, list_, send_) and descriptions present. However, critical gaps: (1) Input schemas visible but many parameters lack type constraints and validation rules in descriptions. (2) Output schemas NOT documented, no indication of return structure, fields, or pagination. (3) Descriptions are functional but generic (avg ~80 chars), lacking WHEN to use, prerequisites, or error recovery guidance. (4) No parameter descriptions visible in schema definitions, only tool-level docstrings. (5) No error handling patterns documented. (6) Destructive tools (delete_agent_time, delete_agent_user) lack confirmation/dry-run patterns. Example: uofx_custom_apply_bpm_form accepts 'fields' as array but no schema for field structure. uofx_custom_get_my_punch_history requires date format YYYY-MM-DD but no regex/pattern constraint in schema. Most tools are READ_ONLY or WRITE, but no permission scopes declared.
為主動發起外部表單
刪除指定的代理時間段。time_id 從 get_my_agent_settings 的回傳中取得。
刪除指定的代理人設定。agent_id 從 get_my_agent_settings 的回傳中取得。
查詢使用者可以被代理的表單清單
取得完整組織架構部門清單
查詢使用者可發起的表單
查詢特定部門的員工名單
Output schemas not documented. No indication of return structure, field names, types, or pagination. LLMs cannot plan downstream tool calls or extract required data.
Parameter descriptions missing from input schemas. Only tool-level docstrings exist; individual parameters lack type constraints, format rules, and validation guidance. E.g., 'fields' in apply_bpm_form is array but no schema for field structure; date parameters lack regex patterns.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2026-07-28+ | v2 |
查詢特定部門的主管資訊
查詢部門人員的異常打卡紀錄。日期格式 YYYY-MM-DD
查詢起單時所需的欄位格式
查詢 ISO 管制文件狀態
查詢使用者的代理人設定狀態(含 ID,可用於後續刪除操作)
取得使用者的完整身份(姓名、部門、職稱等),所有其他 Tool 的前置必要步驟。user_type: 0 為帳號,1 為員工編號。
查詢個人出勤紀錄,並指出打卡異常(遲到/早退/未打卡)。日期格式 YYYY-MM-DD
查詢使用者的未填問卷
查詢使用者的待辦簽核表單
查詢單據詳細進度與狀態
查詢 DMS 文件目錄。不指定 root_code 回傳根目錄;指定的話回傳該目錄底下的子目錄
引導使用者完成 UOF X OAuth 登入。當出現權限錯誤時,請呼叫此工具並將登入指引提供給使用者。登入完成後,無需重啟 MCP Server,直接重試即可。
搜尋 DMS 文件庫中的文件。keyword=檔名關鍵字, folder_path=指定搜尋路徑(如'/公司規章/人事管理'), category: 0=全部, 1=草稿, 2=發行, 3=作廢
發送內部系統通知。支援「個人」或「部門全體」模式(迴圈發送)。
新增代理時間段(ISO8601 格式含時區,如 2026-06-22T00:00:00+08:00)。時間段不可重疊,重疊請先刪除舊設定。
新增代理人。不填 from_dept_code 表示代理全部部門的表單。
測試用的 Tool,示範如何不依賴參數,直接從連線 Context 中得知使用者是誰
Destructive tools lack confirmation/dry-run patterns. delete_agent_time and delete_agent_user are DESTRUCTIVE but offer no confirmation step or preview. Agents can accidentally delete settings without review.
No error handling guidance. Tool descriptions do not explain what to do on failure (retry, ask user, abort). No recovery paths documented. E.g., if apply_bpm_form fails, should the agent retry or ask the user to check form_id?
No permission scopes declared. Tools marked READ_ONLY, WRITE, DESTRUCTIVE but no scope names (e.g., 'read:punch', 'write:agent', 'delete:agent'). Prevents least-privilege agent configuration and audit clarity.