This skill provides a comprehensive framework for developers building or maintaining UniFi MCP servers, ensuring that all resource update operations follow a standardized four-step process: fetch, deep-copy, deep-merge, and put. By enforcing this pattern, it prevents the common pitfall where partial updates accidentally overwrite existing data on the controller. The skill includes specific guidance on handling UniFi V2 API response envelopes, implementing user-friendly MCP tool interfaces with delta previews, and maintaining field symmetry between read and write surfaces to ensure full API coverage and robust data integrity.
主要功能
01Mandatory fetch-merge-put pattern to prevent silent data loss
02V2 API response envelope unwrapping and normalization
03MCP tool UX standards using dictionary parameters and delta previews
04Field symmetry validation and Pydantic model blast-radius protection
05426 GitHub stars
06Deep merge logic for handling complex dictionary and list updates
使用场景
01Adding a new update tool to a UniFi MCP server (Network, Protect, Access, or Drive)
02Refactoring existing update tools to fix data-overwriting bugs and cache corruption
03Ensuring field symmetry between list/get and update operations for a resource domain