Giant Swarm App Platform MCP Server

MCP Server for Giant Swarm App Platform

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

Features

• 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

Prerequisites

• Go 1.21 or later
• Access to a Giant Swarm management cluster
• Kubernetes credentials configured (kubectl access)

Installation

Prerequisites

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

Building from Source

# 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

Usage

Running the Server

The server runs using stdio transport by default:

# Run directly
./build/mcp-giantswarm-apps

# Or if installed
mcp-giantswarm-apps

Configuration

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

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

Integration with AI Assistants

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

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

Available Tools

App Management

• 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 Management

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

App Catalog Entries

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

Configuration Management

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

Organization Management

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

Cluster Management (CAPI)

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

System Tools

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

Available Resources

The server exposes various resources:

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

Usage Examples

List workload clusters

# 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 workload cluster

# 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 apps in a workload cluster

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

Development

Project Structure

.
├── 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

Running Tests

make test

Contributing

Please see CONTRIBUTING.md for guidelines.

License

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

Support

For issues and feature requests, please use the GitHub issue tracker.