ui-cli 1.2.1__tar.gz → 2.1.0__tar.gz

{ui_cli-1.2.1 → ui_cli-2.1.0}/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.0] - 2026-06-26
+
+### Added
+
+- `ui lo firewall add` for creating classic local-controller firewall rules, including
+  IPv4 source/destination filters, port filters, logging, dry-run output, and
+  `--before`/`--after` ordering helpers.
+
+## [2.0.0] - 2026-04-16
+
+### Removed
+
+- Removed the legacy `ui-mcp` server and the `ui mcp` command tree; `ui-cli` is now a CLI-only package again
+- Dropped MCP-related packaging entry points, optional dependencies, and bundled documentation
+
 ## [1.2.1] - 2026-04-16
 
 ### Changed

{ui_cli-1.2.1 → ui_cli-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ui-cli
-Version: 1.2.1
+Version: 2.1.0
 Summary: CLI utility for UniFi Site Manager and local controller APIs
 Project-URL: Homepage, https://github.com/vedanta/ui-cli
 Project-URL: Documentation, https://vedanta.github.io/ui-cli
@@ -32,8 +32,6 @@ Requires-Dist: mypy>=1.10.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
 Requires-Dist: pytest>=8.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.5.0; extra == 'dev'
-Provides-Extra: mcp
-Requires-Dist: mcp>=1.0.0; extra == 'mcp'
 Description-Content-Type: text/markdown
 
 # UniFi CLI
@@ -64,7 +62,6 @@ Description-Content-Type: text/markdown
 - [Cloud API Commands](#cloud-api-commands)
 - [Local Controller Commands](#local-controller-commands)
 - [Client Groups](#client-groups)
-- [Claude Desktop Integration](#claude-desktop-integration)
 - [Output Formats](#output-formats)
 - [Command Reference](#command-reference)
 - [Data Storage](#data-storage)
@@ -101,12 +98,6 @@ UI-CLI is a comprehensive command-line tool for managing UniFi network infrastru
 - **Guest Management** - Create hotspot vouchers with custom duration, data limits, and speed caps, list and delete existing vouchers
 - **Configuration Export** - Export running config to YAML/JSON for backup, filter by section (networks, wireless, firewall, devices)
 
-**Claude Desktop Integration (MCP)**
-- Natural language control of your network via Claude Desktop
-- 21 tools covering status, health, client management, device control, groups, and vouchers
-- Ask questions like "How many devices are connected?" or "Block the kids iPad"
-- Group actions like "Block all kids devices" or "Show status of smart bulbs"
-
 **General**
 - Multiple output formats: table (human-readable), JSON (scripting), CSV (spreadsheets), YAML (config)
 - Works with UDM, UDM Pro, UDM SE, Cloud Key, and self-hosted controllers
@@ -549,6 +540,21 @@ Requires `UNIFI_CONTROLLER_URL`, `UNIFI_CONTROLLER_USERNAME`, and `UNIFI_CONTROL
 ./ui lo firewall list -v               # Verbose with full details
 ./ui lo firewall list -o json          # JSON output
 
+# Create a targeted inter-VLAN allow rule
+./ui lo firewall add "Allow Hermes to MacBook MoneyMoney MCP" \
+  --ruleset LAN_IN \
+  --action accept \
+  --protocol tcp \
+  --src 192.168.60.63/32 \
+  --dst 192.168.2.120/32 \
+  --dst-port 3850 \
+  --before "VLAN60" \
+  --logging \
+  -y
+
+# Preview the UniFi payload without changing the controller
+./ui lo firewall add "Allow MCP" --protocol tcp --dst-port 3850 --dry-run -o json
+
 # Address and port groups
 ./ui lo firewall groups                # List all groups
 ./ui lo firewall groups -v             # Show group members
@@ -835,102 +841,6 @@ Auto groups dynamically match clients based on rules. Members are evaluated at q
 
 ---
 
-## Claude Desktop Integration
-
-Control your UniFi network using natural language through [Claude Desktop](https://claude.ai/download).
-
-### Setup
-
-```bash
-# Install MCP server to Claude Desktop
-./ui mcp install
-
-# Verify installation
-./ui mcp check
-
-# View current configuration
-./ui mcp show
-
-# Restart Claude Desktop to activate
-```
-
-### MCP Commands
-
-```bash
-./ui mcp install    # Add to Claude Desktop config
-./ui mcp check      # Verify setup and connectivity
-./ui mcp show       # View current configuration
-./ui mcp remove     # Remove from Claude Desktop
-```
-
-### Example Prompts
-
-| You say... | Claude does... |
-|------------|----------------|
-| "How many devices are on my network?" | Counts clients by type |
-| "What's my network health?" | Shows WAN/LAN/WLAN/VPN status |
-| "What's my internet speed?" | Shows last speed test result |
-| "Run a speed test" | Initiates new speed test |
-| "Find my iPhone" | Searches for client by name |
-| "Is the TV online?" | Checks client status |
-| "Block the kids iPad" | Blocks specific client |
-| "Unblock the kids iPad" | Unblocks client |
-| "Block all kids devices" | Blocks entire group |
-| "Restart the garage AP" | Restarts device |
-| "Create a guest WiFi voucher" | Creates voucher |
-| "What groups do I have?" | Lists all groups |
-| "Show the kids devices group" | Shows group details |
-
-### Available Tools (21)
-
-| Category | Tools | Description |
-|----------|-------|-------------|
-| **Status & Health** | `network_status` | Check API connectivity |
-| | `network_health` | Site health summary |
-| | `internet_speed` | Last speed test result |
-| | `run_speedtest` | Run new speed test |
-| | `isp_performance` | ISP metrics over time |
-| **Counts & Lists** | `client_count` | Count clients by category |
-| | `device_list` | List UniFi devices |
-| | `network_list` | List networks/VLANs |
-| **Lookups** | `find_client` | Find client by name/MAC |
-| | `find_device` | Find device by name/MAC/IP |
-| | `client_status` | Check if client is online/blocked |
-| **Actions** | `block_client` | Block from network |
-| | `unblock_client` | Restore access |
-| | `kick_client` | Force disconnect |
-| | `restart_device` | Reboot device |
-| | `create_voucher` | Create guest WiFi code |
-| **Groups** | `list_groups` | List all client groups |
-| | `get_group` | Get group details |
-| | `block_group` | Block all in group |
-| | `unblock_group` | Unblock all in group |
-| | `group_status` | Live status of group members |
-
-### Architecture
-
-```
-┌─────────────────┐
-│  Claude Desktop │
-└────────┬────────┘
-         │ MCP Protocol (stdio)
-         ▼
-┌─────────────────┐
-│   MCP Server    │  ← 21 AI-optimized tools
-│   (ui_mcp)      │
-└────────┬────────┘
-         │ subprocess
-         ▼
-┌─────────────────┐
-│    UI CLI       │  ← All business logic
-│   (ui_cli)      │
-└─────────────────┘
-```
-
-See [MCP Documentation](src/ui_mcp/README.md) for full technical details.
-
----
-
 ## Output Formats
 
 All commands support multiple output formats:
@@ -1002,8 +912,7 @@ NO_COLOR=1 ./ui lo health
 ├── isp                 # ISP metrics (cloud)
 ├── sdwan               # SD-WAN configuration (cloud)
 ├── groups              # Client groups (local storage)
-├── local / lo          # Local controller commands
-└── mcp                 # Claude Desktop integration
+└── local / lo          # Local controller commands
 ```
 
 ### Cloud API Commands
@@ -1098,6 +1007,10 @@ NO_COLOR=1 ./ui lo health
 ├── list                # List firewall rules
 │   ├── --ruleset       # Filter by ruleset
 │   └── -v              # Verbose
+├── add <name>          # Create a firewall rule
+│   ├── --src/--dst     # IPv4 address/CIDR filters
+│   ├── --dst-port      # Destination port/list/range
+│   └── --before        # Place before rule ID/name
 └── groups              # List address/port groups
     └── -v              # Show members
 
@@ -1190,18 +1103,6 @@ NO_COLOR=1 ./ui lo health
 
 </details>
 
-### MCP Commands
-
-```
-./ui mcp
-├── install             # Add to Claude Desktop config
-├── check               # Verify setup
-├── show                # View current config
-└── remove              # Remove from Claude Desktop
-```
-
----
-
 ## Data Storage
 
 UI-CLI stores local data in `~/.config/ui-cli/`:
@@ -1285,7 +1186,6 @@ rm ~/.config/ui-cli/session.json
 ./ui lo --help
 ./ui lo clients --help
 ./ui groups --help
-./ui mcp --help
 ```
 
 ---
@@ -1297,8 +1197,6 @@ rm ~/.config/ui-cli/session.json
 | [Online Documentation](https://vedanta.github.io/ui-cli) | Full documentation site |
 | [User Guide](USERGUIDE.md) | Detailed usage examples |
 | [Client Groups](docs/groups.md) | Groups feature guide |
-| [MCP Server](src/ui_mcp/README.md) | Claude Desktop integration |
-| [MCP Architecture](src/ui_mcp/ARCHITECTURE.md) | Technical design |
 | [Roadmap](ROADMAP.md) | Planned features |
 | [Changelog](CHANGELOG.md) | Version history |
 

{ui_cli-1.2.1 → ui_cli-2.1.0}/README.md

@@ -26,7 +26,6 @@
 - [Cloud API Commands](#cloud-api-commands)
 - [Local Controller Commands](#local-controller-commands)
 - [Client Groups](#client-groups)
-- [Claude Desktop Integration](#claude-desktop-integration)
 - [Output Formats](#output-formats)
 - [Command Reference](#command-reference)
 - [Data Storage](#data-storage)
@@ -63,12 +62,6 @@ UI-CLI is a comprehensive command-line tool for managing UniFi network infrastru
 - **Guest Management** - Create hotspot vouchers with custom duration, data limits, and speed caps, list and delete existing vouchers
 - **Configuration Export** - Export running config to YAML/JSON for backup, filter by section (networks, wireless, firewall, devices)
 
-**Claude Desktop Integration (MCP)**
-- Natural language control of your network via Claude Desktop
-- 21 tools covering status, health, client management, device control, groups, and vouchers
-- Ask questions like "How many devices are connected?" or "Block the kids iPad"
-- Group actions like "Block all kids devices" or "Show status of smart bulbs"
-
 **General**
 - Multiple output formats: table (human-readable), JSON (scripting), CSV (spreadsheets), YAML (config)
 - Works with UDM, UDM Pro, UDM SE, Cloud Key, and self-hosted controllers
@@ -511,6 +504,21 @@ Requires `UNIFI_CONTROLLER_URL`, `UNIFI_CONTROLLER_USERNAME`, and `UNIFI_CONTROL
 ./ui lo firewall list -v               # Verbose with full details
 ./ui lo firewall list -o json          # JSON output
 
+# Create a targeted inter-VLAN allow rule
+./ui lo firewall add "Allow Hermes to MacBook MoneyMoney MCP" \
+  --ruleset LAN_IN \
+  --action accept \
+  --protocol tcp \
+  --src 192.168.60.63/32 \
+  --dst 192.168.2.120/32 \
+  --dst-port 3850 \
+  --before "VLAN60" \
+  --logging \
+  -y
+
+# Preview the UniFi payload without changing the controller
+./ui lo firewall add "Allow MCP" --protocol tcp --dst-port 3850 --dry-run -o json
+
 # Address and port groups
 ./ui lo firewall groups                # List all groups
 ./ui lo firewall groups -v             # Show group members
@@ -797,102 +805,6 @@ Auto groups dynamically match clients based on rules. Members are evaluated at q
 
 ---
 
-## Claude Desktop Integration
-
-Control your UniFi network using natural language through [Claude Desktop](https://claude.ai/download).
-
-### Setup
-
-```bash
-# Install MCP server to Claude Desktop
-./ui mcp install
-
-# Verify installation
-./ui mcp check
-
-# View current configuration
-./ui mcp show
-
-# Restart Claude Desktop to activate
-```
-
-### MCP Commands
-
-```bash
-./ui mcp install    # Add to Claude Desktop config
-./ui mcp check      # Verify setup and connectivity
-./ui mcp show       # View current configuration
-./ui mcp remove     # Remove from Claude Desktop
-```
-
-### Example Prompts
-
-| You say... | Claude does... |
-|------------|----------------|
-| "How many devices are on my network?" | Counts clients by type |
-| "What's my network health?" | Shows WAN/LAN/WLAN/VPN status |
-| "What's my internet speed?" | Shows last speed test result |
-| "Run a speed test" | Initiates new speed test |
-| "Find my iPhone" | Searches for client by name |
-| "Is the TV online?" | Checks client status |
-| "Block the kids iPad" | Blocks specific client |
-| "Unblock the kids iPad" | Unblocks client |
-| "Block all kids devices" | Blocks entire group |
-| "Restart the garage AP" | Restarts device |
-| "Create a guest WiFi voucher" | Creates voucher |
-| "What groups do I have?" | Lists all groups |
-| "Show the kids devices group" | Shows group details |
-
-### Available Tools (21)
-
-| Category | Tools | Description |
-|----------|-------|-------------|
-| **Status & Health** | `network_status` | Check API connectivity |
-| | `network_health` | Site health summary |
-| | `internet_speed` | Last speed test result |
-| | `run_speedtest` | Run new speed test |
-| | `isp_performance` | ISP metrics over time |
-| **Counts & Lists** | `client_count` | Count clients by category |
-| | `device_list` | List UniFi devices |
-| | `network_list` | List networks/VLANs |
-| **Lookups** | `find_client` | Find client by name/MAC |
-| | `find_device` | Find device by name/MAC/IP |
-| | `client_status` | Check if client is online/blocked |
-| **Actions** | `block_client` | Block from network |
-| | `unblock_client` | Restore access |
-| | `kick_client` | Force disconnect |
-| | `restart_device` | Reboot device |
-| | `create_voucher` | Create guest WiFi code |
-| **Groups** | `list_groups` | List all client groups |
-| | `get_group` | Get group details |
-| | `block_group` | Block all in group |
-| | `unblock_group` | Unblock all in group |
-| | `group_status` | Live status of group members |
-
-### Architecture
-
-```
-┌─────────────────┐
-│  Claude Desktop │
-└────────┬────────┘
-         │ MCP Protocol (stdio)
-         ▼
-┌─────────────────┐
-│   MCP Server    │  ← 21 AI-optimized tools
-│   (ui_mcp)      │
-└────────┬────────┘
-         │ subprocess
-         ▼
-┌─────────────────┐
-│    UI CLI       │  ← All business logic
-│   (ui_cli)      │
-└─────────────────┘
-```
-
-See [MCP Documentation](src/ui_mcp/README.md) for full technical details.
-
----
-
 ## Output Formats
 
 All commands support multiple output formats:
@@ -964,8 +876,7 @@ NO_COLOR=1 ./ui lo health
 ├── isp                 # ISP metrics (cloud)
 ├── sdwan               # SD-WAN configuration (cloud)
 ├── groups              # Client groups (local storage)
-├── local / lo          # Local controller commands
-└── mcp                 # Claude Desktop integration
+└── local / lo          # Local controller commands
 ```
 
 ### Cloud API Commands
@@ -1060,6 +971,10 @@ NO_COLOR=1 ./ui lo health
 ├── list                # List firewall rules
 │   ├── --ruleset       # Filter by ruleset
 │   └── -v              # Verbose
+├── add <name>          # Create a firewall rule
+│   ├── --src/--dst     # IPv4 address/CIDR filters
+│   ├── --dst-port      # Destination port/list/range
+│   └── --before        # Place before rule ID/name
 └── groups              # List address/port groups
     └── -v              # Show members
 
@@ -1152,18 +1067,6 @@ NO_COLOR=1 ./ui lo health
 
 </details>
 
-### MCP Commands
-
-```
-./ui mcp
-├── install             # Add to Claude Desktop config
-├── check               # Verify setup
-├── show                # View current config
-└── remove              # Remove from Claude Desktop
-```
-
----
-
 ## Data Storage
 
 UI-CLI stores local data in `~/.config/ui-cli/`:
@@ -1247,7 +1150,6 @@ rm ~/.config/ui-cli/session.json
 ./ui lo --help
 ./ui lo clients --help
 ./ui groups --help
-./ui mcp --help
 ```
 
 ---
@@ -1259,8 +1161,6 @@ rm ~/.config/ui-cli/session.json
 | [Online Documentation](https://vedanta.github.io/ui-cli) | Full documentation site |
 | [User Guide](USERGUIDE.md) | Detailed usage examples |
 | [Client Groups](docs/groups.md) | Groups feature guide |
-| [MCP Server](src/ui_mcp/README.md) | Claude Desktop integration |
-| [MCP Architecture](src/ui_mcp/ARCHITECTURE.md) | Technical design |
 | [Roadmap](ROADMAP.md) | Planned features |
 | [Changelog](CHANGELOG.md) | Version history |
 

ui_cli-2.1.0/VERSION

@@ -0,0 +1 @@
+2.1.0

{ui_cli-1.2.1 → ui_cli-2.1.0}/pyproject.toml

@@ -36,9 +36,6 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-mcp = [
-    "mcp>=1.0.0",
-]
 dev = [
     "pytest>=8.0.0",
     "pytest-asyncio>=0.23.0",
@@ -48,7 +45,6 @@ dev = [
 
 [project.scripts]
 ui = "ui_cli.main:app"
-ui-mcp = "ui_mcp.server:main"
 
 [tool.hatch.version]
 source = "regex"
@@ -58,7 +54,6 @@ pattern = "(?m)^(?P<version>\\d+\\.\\d+\\.\\d+)$"
 [tool.hatch.build.targets.sdist]
 include = [
     "/src/ui_cli",
-    "/src/ui_mcp",
     "/README.md",
     "/CHANGELOG.md",
     "/LICENSE",
@@ -66,7 +61,7 @@ include = [
 ]
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/ui_cli", "src/ui_mcp"]
+packages = ["src/ui_cli"]
 
 [tool.ruff]
 line-length = 100