Enables an AI client to create, manage, and operate Kubernetes clusters and workloads across local and cloud environments.
Also known as devantler-tech/ksail
- Stars
- 164
- Tools
- โ
- Downloads, 30 days
- โ
- Latest version
- 7.213.42
- Last commit
- Nov 14, 2026
- License
- โ
What is KSail MCP?
KSail enables an AI client to create, manage, and operate Kubernetes clusters and workloads across local and cloud environments.
Summary generated from the project's README
About KSail MCP server
KSail provides a unified interface for managing Kubernetes clusters and application workloads across various environments. Developers can use this MCP server to orchestrate local clusters using Docker, Kind, K3d, or Talos, as well as manage cloud-based infrastructure on EKS, GKE, and AKS. It also supports simulation through KWOK and multi-tenancy via vCluster.
This tool integrates directly with AI clients, VS Code, and the terminal to handle deployment tasks using Helm, Kustomize, Flux, and ArgoCD. It includes security features like secret encryption with SOPS and Age, alongside manifest validation through Kubeconform. Users can also perform cluster operations using K9s or manage backup and restore procedures.
Setting up the server requires local installation via curl or Homebrew on Linux and Apple Silicon Macs. While local clusters run on Docker, cloud provider integrations require existing accounts and will incur standard provider charges. The system allows for rapid project initialization and cluster deletion to manage resources effectively.
What you can do with it
- 1Provision local development clustersAsk the AI to set up a local Kubernetes environment using Docker to test new applications.
- 2Deploy applications with GitOpsInstruct the assistant to deploy a workload using specific deployment tools like Helm or ArgoCD.
- 3Secure sensitive configuration dataRequest the AI to encrypt secrets to ensure configuration files remain protected.
- 4Validate Kubernetes manifestsHave the client check that your Kubernetes configuration files are valid before deployment.
Written from the project's README. Every use case is checked against a quote from it.
How to install KSail MCP
Formats verified 10 Nov 2026Install KSail MCP in Claude Code
$ claude mcp add ksail -- docker run -i --rm ghcr.io/devantler-tech/ksail:v7.213.42Install KSail MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ksail": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/devantler-tech/ksail:v7.213.42"
]
}
}
}Install KSail MCP in VS Code
.vscode/mcp.json
{
"servers": {
"ksail": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/devantler-tech/ksail:v7.213.42"
]
}
}
}Install KSail MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"ksail": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/devantler-tech/ksail:v7.213.42"
]
}
}
}Install KSail MCP in Codex
~/.codex/config.toml
[mcp_servers.ksail] command = "docker" args = ["run", "-i", "--rm", "ghcr.io/devantler-tech/ksail:v7.213.42"]
Install KSail MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"ksail": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/devantler-tech/ksail:v7.213.42"
]
}
}
}Automated checks
Ran Nov 12, 2026Full report โNot verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearPass
- Package name not close to a popular packageNot checked
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHub
๐ฅ๏ธ๐ณ KSail
KSail brings Kubernetes cluster setup, application deployment and everyday operations into one tool. Create local clusters with Docker, or work with supported cloud providers and existing Kubernetes clusters. Use it from your terminal, VS Code or an AI assistant.
๐ Documentation ยท Quickstart ยท Support
What you get
| Task | Included tools and capabilities |
|---|---|
| Create clusters | Kind, K3d, Talos, vCluster, KWOK, EKS, GKE and AKS |
| Deploy applications | kubectl, Helm, Kustomize, Flux and ArgoCD |
| Protect configuration | Encrypt secrets with SOPS and Age; validate manifests with Kubeconform |
| Operate clusters | K9s, backup and restore, multi-tenancy |
| Work with AI | Chat assistant, MCP server and VS Code extension |
See features and the support matrix for supported platforms and combinations. KWOK simulates clusters; it does not run applications. Cloud providers need their own setup and incur charges.
Quick install
On Linux or an Apple Silicon Mac, with curl, tar and sha256sum or shasum available:
curl -fsSL https://github.com/devantler-tech/ksail/releases/latest/download/install.sh | sh
The installer verifies the download and prints where it installed KSail. Follow its PATH
instruction if needed. Prefer Homebrew or a Windows download? See
installation options.
Homebrew installs include Bash, zsh and fish completions. Enable completions using Homebrew's standard shell setup.
Quick start
Create a project in a new directory:
mkdir my-app
cd my-app
ksail project init --name my-app --distribution Vanilla --provider Docker
This creates your project files without needing Docker or a cloud account. With Docker Engine or Docker Desktop running, start and explore a local cluster:
ksail cluster create
ksail cluster connect
This creates a local Kubernetes cluster and opens K9s to explore it. Enter :quit to leave K9s.
When finished, delete the trial cluster and its applications:
ksail cluster delete --name my-app --provider Docker
Review the cluster name and confirm deletion when prompted. Project files remain for reuse.
Continue with the quickstart guide to deploy an application. The reader reference covers local setup details, cloud providers and optional AI assistant plugins.
Community & support
- ๐ฌ Discussions โ questions and ideas.
- ๐ Issues โ bugs and feature requests.
- ๐ Resources โ presentations and tutorials.
- ๐ ๏ธ Contributing โ make your first contribution.
License
KSail is source-available under PolyForm Shield 1.0.0, with use, redistribution and noncompetition terms. See the licensing guide and full license before reusing it.
KSail MCP questions
How do I add KSail MCP to Claude Code?
Run claude mcp add ksail -- docker run -i --rm ghcr.io/devantler-tech/ksail:v7.213.42 in your terminal. Add --scope user to make it available in every project.
How do I add KSail MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What kind of clusters can I create with KSail?
You can create local clusters using Kind, K3d, Talos, vCluster, KWOK, or Docker, as well as cloud-based clusters like EKS, GKE, and AKS.
Does KWOK run actual applications?
No, KWOK is used to simulate clusters but it does not run applications.