Giant Swarm App Platform

A server for managing Giant Swarm App Platform deployments using Kubernetes credentials.

An MCP (Model Context Protocol) server that provides tools and resources for managing Giant Swarm App Platform deployments.

- App Management: Create, update, list, and delete Giant Swarm apps
- Catalog Support: Browse and search app catalogs and available app versions
- Configuration Management: Handle app configurations via ConfigMaps and Secrets
- Multi-namespace Support: Work with organization-based namespaces
- CAPI Integration: Support for workload cluster app deployments
- Prompts: Interactive guides for common operations

- Go 1.21 or later
- Access to a Giant Swarm management cluster
- Kubernetes credentials configured (kubectlaccess)

- Go 1.21 or later
- Access to a Giant Swarm management cluster
- Valid kubeconfig for authentication

# Clone the repository git clone https://github.com/giantswarm/mcp-giantswarm-apps.git cd mcp-giantswarm-apps # Install dependencies make deps # Build the server make build # Install to $GOPATH/bin make install

The server runs using stdio transport by default:

# Run directly ./build/mcp-giantswarm-apps # Or if installed mcp-giantswarm-apps

The server uses your current kubeconfig context by default. You can specify a different context:

export KUBECONFIG=/path/to/kubeconfig mcp-giantswarm-apps

To use with Claude Desktop or other MCP-compatible clients, add to your configuration:

{ "mcpServers": { "giantswarm-apps": { "command": "mcp-giantswarm-apps", "args": [] } } }

- app_list- List Giant Swarm apps with filtering options
- app_get- Get detailed information about a specific app
- app_create- Create a new Giant Swarm app
- app_update- Update an existing app
- app_delete- Delete an app

- catalog_list- List available app catalogs
- catalog_get- Get detailed catalog information
- catalog_refresh- Refresh catalog entries
- catalog_search- Search for apps across catalogs

- appcatalogentry_list- List apps from catalogs
- appcatalogentry_get- Get detailed app information
- appcatalogentry_versions- List available versions
- appcatalogentry_search- Search catalog entries

- config_get- Get app configuration
- config_create- Create new configuration
- config_update- Update configuration
- config_values- Get configuration values

- organization_list- List organizations
- organization_namespaces- List organization namespaces
- organization_info- Get namespace details
- organization_validate_access- Check access permissions

- cluster_list- List available workload clusters
- cluster_get- Get detailed cluster information
- cluster_apps- List apps deployed to a specific cluster

- health- Check server and connection health
- kubernetes_contexts- List available contexts

- app://{namespace}/{name}- App details and status
- catalog://{name}- Catalog information
- config://{namespace}/{app}/values- App configuration

# List all clusters mcp cluster_list # List clusters for an organization mcp cluster_list --organization giantswarm # List only ready clusters mcp cluster_list --ready-only

# Deploy app to a specific workload cluster mcp app_create \ --name nginx-ingress \ --namespace org-giantswarm \ --catalog giantswarm \ --app nginx-ingress-controller \ --version 2.1.0 \ --cluster prod-cluster

# List all apps in a specific cluster mcp cluster_apps --cluster prod-cluster --organization giantswarm

. ├── cmd/mcp-server/ # Main server entry point ├── pkg/ │ ├── app/ # App management logic │ ├── catalog/ # Catalog handling │ └── config/ # Configuration management ├── internal/ │ └── k8s/ # Kubernetes client utilities └── Makefile # Build automation

Please seeCONTRIBUTING.mdfor guidelines.

This project is licensed under the Apache License 2.0 - see theLICENSEfile for details.

For issues and feature requests, please use theGitHub issue tracker.

Integrate with the Coolify API to manage your servers, applications, and databases.