@futuretea/rancher-mcp-server 0.4.5 → 0.5.1

package/README.md

@@ -24,6 +24,10 @@ A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for Ra
   - Analyze node health and resource usage
   - Inspect pods with parent workload, metrics, and logs
   - Show dependency/dependent trees for any resource (inspired by kube-lineage)
+  - **Get all resources** (inspired by [ketall](https://github.com/corneliusweig/ketall)): List all Kubernetes resources including ConfigMaps, Secrets, RBAC, CRDs
+  - **Compare resource versions** (kubernetes_diff): Show git-style diffs between two resource versions
+  - **Watch resource changes** (kubernetes_watch): Monitor resources and return git-style diffs at regular intervals
+  - **Resource capacity overview** (inspired by [kube-capacity](https://github.com/robscott/kube-capacity)): Show cluster resource capacity, requests, limits, and utilization
 - **Rancher Resources via Norman API**: List clusters and projects
 - **Security Controls**:
   - `read_only`: Disables create, patch, and delete operations
@@ -282,6 +286,133 @@ Tools are organized into toolsets. Use `--toolsets` to enable specific sets or `
 
 ### kubernetes
 
+<details>
+<summary>kubernetes_capacity</summary>
+
+Show Kubernetes cluster resource capacity, requests, limits, and utilization. Similar to [kube-capacity](https://github.com/robscott/kube-capacity) CLI tool.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `cluster` | string | Yes | Cluster ID |
+| `pods` | boolean | No | Include individual pod resources in the output (default: false) |
+| `containers` | boolean | No | Include individual container resources in the output (implies pods=true) (default: false) |
+| `util` | boolean | No | Include actual resource utilization from metrics-server (requires metrics-server) (default: false) |
+| `available` | boolean | No | Show raw available capacity instead of percentages (default: false) |
+| `podCount` | boolean | No | Include pod counts for each node and the whole cluster (default: false) |
+| `showLabels` | boolean | No | Include node labels in the output (default: false) |
+| `hideRequests` | boolean | No | Hide request columns from output (default: false) |
+| `hideLimits` | boolean | No | Hide limit columns from output (default: false) |
+| `namespace` | string | No | Filter by namespace (empty for all namespaces) |
+| `labelSelector` | string | No | Filter pods by label selector (e.g., "app=nginx,env=prod") |
+| `nodeLabelSelector` | string | No | Filter nodes by label selector (e.g., "node-role.kubernetes.io/worker=true") |
+| `namespaceLabelSelector` | string | No | Filter namespaces by label selector (e.g., "env=production") |
+| `nodeTaints` | string | No | Filter nodes by taints. Use 'key=value:effect' to include, 'key=value:effect-' to exclude. Multiple taints can be separated by comma |
+| `noTaint` | boolean | No | Exclude nodes with any taints (default: false) |
+| `sortBy` | string | No | Sort by: cpu.util, mem.util, cpu.request, mem.request, cpu.limit, mem.limit, cpu.util.percentage, mem.util.percentage, name |
+| `format` | string | No | Output format: table, json, yaml (default: table) |
+
+**Examples:**
+
+```json
+// Basic node overview
+{
+  "cluster": "c-abc123"
+}
+
+// Include pods detail
+{
+  "cluster": "c-abc123",
+  "pods": true
+}
+
+// Include utilization metrics (requires metrics-server)
+{
+  "cluster": "c-abc123",
+  "util": true
+}
+
+// Full detail with utilization
+{
+  "cluster": "c-abc123",
+  "pods": true,
+  "util": true
+}
+
+// Filter by namespace
+{
+  "cluster": "c-abc123",
+  "namespace": "production"
+}
+
+// Sort by CPU utilization
+{
+  "cluster": "c-abc123",
+  "sortBy": "cpu.util"
+}
+
+// Filter by node labels (show only worker nodes)
+{
+  "cluster": "c-abc123",
+  "nodeLabelSelector": "node-role.kubernetes.io/worker=true"
+}
+
+// Include container-level details
+{
+  "cluster": "c-abc123",
+  "containers": true
+}
+
+// Show pod counts per node
+{
+  "cluster": "c-abc123",
+  "podCount": true
+}
+
+// Show node labels in output
+{
+  "cluster": "c-abc123",
+  "showLabels": true
+}
+
+// Hide request columns (show only limits)
+{
+  "cluster": "c-abc123",
+  "hideRequests": true
+}
+
+// Filter by namespace labels
+{
+  "cluster": "c-abc123",
+  "namespaceLabelSelector": "env=production"
+}
+
+// Filter by node taints (include nodes with specific taint)
+{
+  "cluster": "c-abc123",
+  "nodeTaints": "dedicated=special:NoSchedule"
+}
+
+// Exclude nodes with specific taint
+{
+  "cluster": "c-abc123",
+  "nodeTaints": "dedicated=special:NoSchedule-"
+}
+
+// Exclude all tainted nodes
+{
+  "cluster": "c-abc123",
+  "noTaint": true
+}
+
+// Sort by CPU utilization percentage
+{
+  "cluster": "c-abc123",
+  "sortBy": "cpu.util.percentage"
+}
+```
+
+</details>
+
 <details>
 <summary>kubernetes_dep</summary>
 
@@ -413,6 +544,146 @@ Describe a Kubernetes resource with its related events. Similar to `kubectl desc
 
 </details>
 
+<details>
+<summary>kubernetes_diff</summary>
+
+Compare two Kubernetes resource versions and show the differences as a git-style diff. Useful for comparing current vs desired state, or before/after changes.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `resource1` | string | Yes | First resource version as JSON string (the 'before' or 'old' version). Use kubernetes_get to retrieve the resource. |
+| `resource2` | string | Yes | Second resource version as JSON string (the 'after' or 'new' version). Use kubernetes_get to retrieve the resource. |
+| `ignoreStatus` | boolean | No | Ignore changes under the status field when computing diffs (default: false) |
+| `ignoreMeta` | boolean | No | Ignore non-essential metadata differences like managedFields, resourceVersion, etc. (default: false) |
+
+**Examples:**
+
+```json
+// Compare two versions of the same deployment
+// First, get the current resource
+{
+  "cluster": "c-abc123",
+  "kind": "deployment",
+  "namespace": "default",
+  "name": "nginx"
+}
+// Then compare with previous version (from rollout history)
+{
+  "resource1": "<previous-revision-json>",
+  "resource2": "<current-revision-json>",
+  "ignoreMeta": true
+}
+```
+
+</details>
+
+<details>
+<summary>kubernetes_get_all</summary>
+
+Get really all Kubernetes resources in the cluster (inspired by [ketall](https://github.com/corneliusweig/ketall)). Unlike `kubectl get all`, this shows all resource types including ConfigMaps, Secrets, RBAC resources, CRDs, and other resources that are normally hidden.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `cluster` | string | Yes | Cluster ID |
+| `namespace` | string | No | Filter by namespace (optional, empty for all namespaces) |
+| `name` | string | No | Filter by resource name (partial match, client-side) |
+| `labelSelector` | string | No | Label selector for filtering (e.g., "app=nginx,env=prod") |
+| `excludeEvents` | boolean | No | Exclude events from output (default: true, as events are often noisy) |
+| `scope` | string | No | Filter by scope: 'namespaced' for namespaced resources only, 'cluster' for cluster-scoped resources only, or empty for all |
+| `since` | string | No | Only show resources created since this duration (e.g., '1h30m', '2d', '1w') |
+| `limit` | integer | No | Limit number of resources per API call (0 for no limit, default: 0) |
+| `format` | string | No | Output format: json, table, yaml (default: table) |
+
+**Examples:**
+
+```json
+// Get all resources in the cluster
+{
+  "cluster": "c-abc123"
+}
+
+// Get all resources in a specific namespace
+{
+  "cluster": "c-abc123",
+  "namespace": "production"
+}
+
+// Get only cluster-scoped resources
+{
+  "cluster": "c-abc123",
+  "scope": "cluster"
+}
+
+// Get resources created in the last 24 hours
+{
+  "cluster": "c-abc123",
+  "since": "24h"
+}
+
+// Get all resources with specific labels
+{
+  "cluster": "c-abc123",
+  "labelSelector": "app=nginx,env=prod"
+}
+```
+
+</details>
+
+<details>
+<summary>kubernetes_watch</summary>
+
+Watch Kubernetes resources and return git-style diffs of changes at regular intervals, similar to the Linux `watch` command.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `cluster` | string | Yes | Cluster ID |
+| `kind` | string | Yes | Resource kind (e.g., pod, deployment, service, or dotted `resource.group` form) |
+| `namespace` | string | No | Namespace (empty = all namespaces or cluster-scoped resources) |
+| `labelSelector` | string | No | Label selector (e.g., "app=nginx,env=prod") |
+| `fieldSelector` | string | No | Field selector for filtering resources |
+| `ignoreStatus` | boolean | No | Ignore changes under the `status` field when computing diffs (similar to `--no-status`) |
+| `ignoreMeta` | boolean | No | Ignore non-essential metadata differences (similar to `--no-meta`) |
+| `intervalSeconds` | integer | No | Interval in seconds between evaluations (default: 10, min: 1, max: 600) |
+| `iterations` | integer | No | Number of times to re-evaluate and diff before returning (default: 6, min: 1, max: 100) |
+
+**Notes:**
+- Each iteration compares the current resource state with the previous iteration and only emits diffs when there are changes.
+- The tool returns the concatenated diffs for all iterations in a single response.
+
+**Examples:**
+
+```json
+// Watch pods in a namespace for changes
+{
+  "cluster": "c-abc123",
+  "kind": "pod",
+  "namespace": "production",
+  "intervalSeconds": 5,
+  "iterations": 3
+}
+
+// Watch deployments and ignore status changes
+{
+  "cluster": "c-abc123",
+  "kind": "deployment",
+  "namespace": "default",
+  "ignoreStatus": true,
+  "intervalSeconds": 10,
+  "iterations": 6
+}
+
+// Watch resources by label selector
+{
+  "cluster": "c-abc123",
+  "kind": "pod",
+  "labelSelector": "app=nginx",
+  "intervalSeconds": 5,
+  "iterations": 12
+}
+```
+
+</details>
+
 <details>
 <summary>kubernetes_events</summary>
 

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@futuretea/rancher-mcp-server",
-  "version": "0.4.5",
+  "version": "0.5.1",
   "description": "Model Context Protocol (MCP) server for Rancher multi-cluster management",
   "main": "./bin/index.js",
   "bin": {
     "rancher-mcp-server": "bin/index.js"
   },
   "optionalDependencies": {
-    "@futuretea/rancher-mcp-server-darwin-amd64": "0.4.5",
-    "@futuretea/rancher-mcp-server-darwin-arm64": "0.4.5",
-    "@futuretea/rancher-mcp-server-linux-amd64": "0.4.5",
-    "@futuretea/rancher-mcp-server-linux-arm64": "0.4.5",
-    "@futuretea/rancher-mcp-server-windows-amd64": "0.4.5",
-    "@futuretea/rancher-mcp-server-windows-arm64": "0.4.5"
+    "@futuretea/rancher-mcp-server-darwin-amd64": "0.5.1",
+    "@futuretea/rancher-mcp-server-darwin-arm64": "0.5.1",
+    "@futuretea/rancher-mcp-server-linux-amd64": "0.5.1",
+    "@futuretea/rancher-mcp-server-linux-arm64": "0.5.1",
+    "@futuretea/rancher-mcp-server-windows-amd64": "0.5.1",
+    "@futuretea/rancher-mcp-server-windows-arm64": "0.5.1"
   },
   "repository": {
     "type": "git",