unifi-mcp-server: Skill for Claude Code

source-command-unifi-mcp-update-docs

Use this skill when the user asks to run the migrated source command unifi-mcp-update-docs.

Command Template

Automatically generate and update API.md documentation from tool docstrings and code.

This command scans all MCP tools and resources, extracts documentation from code, and updates API.md to ensure it stays in sync with the implementation.

Steps to execute:

1. Discover all MCP tools:

   • Scan src/tools/ directory for all tool modules
   • Import each module and extract tool functions
   • Parse docstrings to get:
     • Description
     • Parameters with types and descriptions
     • Return values
     • Raises (errors)
     • Example usage

2. Discover all MCP resources:

   • Scan src/resources/ directory for resource handlers
   • Extract resource URI templates
   • Document available operations (list, read, subscribe)

3. Categorize tools by functionality:

   • Site Management
   • Device Operations
   • Client Management
   • Network Configuration
   • WiFi/WLAN Management
   • Firewall & Security
   • Port Forwarding
   • DPI (Deep Packet Inspection)
   • Zone-Based Firewall
   • Traffic Flows
   • Vouchers
   • Webhooks

4. Read current API.md to preserve:

   • Overview and introduction sections
   • Authentication details
   • Rate limiting information
   • Error handling guide
   • Custom examples or notes

5. Generate updated documentation:

   • Table of contents with all categories

   • Tool documentation for each category:

     ### tool_name
     
     **Description:** Brief description
     
     **Parameters:**
     - `param1` (type): Description
     - `param2` (type, optional): Description
     
     **Returns:** Return value description
     
     **Example:**
     ```json
     {
       "tool": "tool_name",
       "arguments": {
         "param1": "value1"
       }
     }
     

6. Update API.md:

   • Preserve manual sections (overview, auth, errors)
   • Replace tool documentation sections
   • Add new tools that aren't documented
   • Remove documentation for deleted tools
   • Update version number and last updated date