kubernetes-mcp-server
Advanced tools
Comparing version
{ | ||
"name": "kubernetes-mcp-server", | ||
"version": "0.0.26", | ||
"version": "0.0.27", | ||
"description": "Model Context Protocol (MCP) server for Kubernetes and OpenShift", | ||
@@ -10,8 +10,8 @@ "main": "./bin/index.js", | ||
"optionalDependencies": { | ||
"kubernetes-mcp-server-darwin-amd64": "0.0.26", | ||
"kubernetes-mcp-server-darwin-arm64": "0.0.26", | ||
"kubernetes-mcp-server-linux-amd64": "0.0.26", | ||
"kubernetes-mcp-server-linux-arm64": "0.0.26", | ||
"kubernetes-mcp-server-windows-amd64": "0.0.26", | ||
"kubernetes-mcp-server-windows-arm64": "0.0.26" | ||
"kubernetes-mcp-server-darwin-amd64": "0.0.27", | ||
"kubernetes-mcp-server-darwin-arm64": "0.0.27", | ||
"kubernetes-mcp-server-linux-amd64": "0.0.27", | ||
"kubernetes-mcp-server-linux-arm64": "0.0.27", | ||
"kubernetes-mcp-server-windows-amd64": "0.0.27", | ||
"kubernetes-mcp-server-windows-arm64": "0.0.27" | ||
}, | ||
@@ -18,0 +18,0 @@ "repository": { |
170
README.md
@@ -8,3 +8,3 @@ # Kubernetes MCP Server | ||
[✨ Features](#features) | [🚀 Getting Started](#getting-started) | [🎥 Demos](#demos) | [⚙️ Configuration](#configuration) | [🧑💻 Development](#development) | ||
[✨ Features](#features) | [🚀 Getting Started](#getting-started) | [🎥 Demos](#demos) | [⚙️ Configuration](#configuration) | [🛠️ Tools](#tools) | [🧑💻 Development](#development) | ||
@@ -69,2 +69,3 @@ https://github.com/user-attachments/assets/be2b67b3-fc1c-4d11-ae46-93deba8ed98e | ||
[<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522kubernetes%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522kubernetes-mcp-server%2540latest%2522%255D%257D) | ||
[<img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522kubernetes%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522kubernetes-mcp-server%2540latest%2522%255D%257D) | ||
@@ -139,2 +140,169 @@ | ||
## 🛠️ Tools <a id="tools"></a> | ||
### `configuration_view` | ||
Get the current Kubernetes configuration content as a kubeconfig YAML | ||
**Parameters:** | ||
- `minified` (`boolean`, optional, default: `true`) | ||
- Return a minified version of the configuration | ||
- If `true`, keeps only the current-context and relevant configuration pieces | ||
- If `false`, returns all contexts, clusters, auth-infos, and users | ||
### `events_list` | ||
List all the Kubernetes events in the current cluster from all namespaces | ||
**Parameters:** | ||
- `namespace` (`string`, optional) | ||
- Namespace to retrieve the events from. If not provided, will list events from all namespaces | ||
### `namespaces_list` | ||
List all the Kubernetes namespaces in the current cluster | ||
**Parameters:** None | ||
### `pods_delete` | ||
Delete a Kubernetes Pod in the current or provided namespace with the provided name | ||
**Parameters:** | ||
- `name` (`string`, required) | ||
- Name of the Pod to delete | ||
- `namespace` (`string`, required) | ||
- Namespace to delete the Pod from | ||
### `pods_exec` | ||
Execute a command in a Kubernetes Pod in the current or provided namespace with the provided name and command | ||
**Parameters:** | ||
- `command` (`string[]`, required) | ||
- Command to execute in the Pod container | ||
- First item is the command, rest are arguments | ||
- Example: `["ls", "-l", "/tmp"]` | ||
- `name` (string, required) | ||
- Name of the Pod | ||
- `namespace` (string, required) | ||
- Namespace of the Pod | ||
### `pods_get` | ||
Get a Kubernetes Pod in the current or provided namespace with the provided name | ||
**Parameters:** | ||
- `name` (`string`, required) | ||
- Name of the Pod | ||
- `namespace` (`string`, required) | ||
- Namespace to get the Pod from | ||
### `pods_list` | ||
List all the Kubernetes pods in the current cluster from all namespaces | ||
**Parameters:** None | ||
### `pods_list_in_namespace` | ||
List all the Kubernetes pods in the specified namespace in the current cluster | ||
**Parameters:** | ||
- `namespace` (`string`, required) | ||
- Namespace to list pods from | ||
### `pods_log` | ||
Get the logs of a Kubernetes Pod in the current or provided namespace with the provided name | ||
**Parameters:** | ||
- `name` (`string`, required) | ||
- Name of the Pod to get logs from | ||
- `namespace` (`string`, required) | ||
- Namespace to get the Pod logs from | ||
- `container` (`string`, optional) | ||
- Name of the Pod container to get logs from | ||
### `pods_run` | ||
Run a Kubernetes Pod in the current or provided namespace with the provided container image and optional name | ||
**Parameters:** | ||
- `image` (`string`, required) | ||
- Container Image to run in the Pod | ||
- `namespace` (`string`, required) | ||
- Namespace to run the Pod in | ||
- `name` (`string`, optional) | ||
- Name of the Pod (random name if not provided) | ||
- `port` (`number`, optional) | ||
- TCP/IP port to expose from the Pod container | ||
- No port exposed if not provided | ||
### `projects_list` | ||
List all the OpenShift projects in the current cluster | ||
### `resources_create_or_update` | ||
Create or update a Kubernetes resource in the current cluster by providing a YAML or JSON representation of the resource | ||
**Parameters:** | ||
- `resource` (`string`, required) | ||
- A JSON or YAML containing a representation of the Kubernetes resource | ||
- Should include top-level fields such as apiVersion, kind, metadata, and spec | ||
**Common apiVersion and kind include:** | ||
- v1 Pod | ||
- v1 Service | ||
- v1 Node | ||
- apps/v1 Deployment | ||
- networking.k8s.io/v1 Ingress | ||
### `resources_delete` | ||
Delete a Kubernetes resource in the current cluster | ||
**Parameters:** | ||
- `apiVersion` (`string`, required) | ||
- apiVersion of the resource (e.g., `v1`, `apps/v1`, `networking.k8s.io/v1`) | ||
- `kind` (`string`, required) | ||
- kind of the resource (e.g., `Pod`, `Service`, `Deployment`, `Ingress`) | ||
- `name` (`string`, required) | ||
- Name of the resource | ||
- `namespace` (`string`, optional) | ||
- Namespace to delete the namespaced resource from | ||
- Ignored for cluster-scoped resources | ||
- Uses configured namespace if not provided | ||
### `resources_get` | ||
Get a Kubernetes resource in the current cluster | ||
**Parameters:** | ||
- `apiVersion` (`string`, required) | ||
- apiVersion of the resource (e.g., `v1`, `apps/v1`, `networking.k8s.io/v1`) | ||
- `kind` (`string`, required) | ||
- kind of the resource (e.g., `Pod`, `Service`, `Deployment`, `Ingress`) | ||
- `name` (`string`, required) | ||
- Name of the resource | ||
- `namespace` (`string`, optional) | ||
- Namespace to retrieve the namespaced resource from | ||
- Ignored for cluster-scoped resources | ||
- Uses configured namespace if not provided | ||
### `resources_list` | ||
List Kubernetes resources and objects in the current cluster | ||
**Parameters:** | ||
- `apiVersion` (`string`, required) | ||
- apiVersion of the resources (e.g., `v1`, `apps/v1`, `networking.k8s.io/v1`) | ||
- `kind` (`string`, required) | ||
- kind of the resources (e.g., `Pod`, `Service`, `Deployment`, `Ingress`) | ||
- `namespace` (`string`, optional) | ||
- Namespace to retrieve the namespaced resources from | ||
- Ignored for cluster-scoped resources | ||
- Lists resources from all namespaces if not provided | ||
## 🧑💻 Development <a id="development"></a> | ||
@@ -141,0 +309,0 @@ |
26311
25.57%317
112.75%