MCP Giantswarm Apps

Giant Swarm应用平台的MCP服务器

MCP（模型上下文协议）服务器，为管理Giant Swarm应用平台部署提供工具和资源。

特性

• 应用程序管理：创建、更新、列出和删除Giant Swarm应用程序
• 目录支持：浏览和搜索应用程序目录和可用应用程序版本
• 配置管理：通过ConfigMaps和Secrets处理应用程序配置
• 多命名空间支持：使用基于组织的命名空间
• CAPI集成：支持工作负载集群应用程序部署
• 鼓励：共同行动互动指南

先决条件

• 转到1.21或更高版本
• 访问Giant Swarm管理集群
• 已配置Kubernetes凭据(kubectl 访问）

安装

先决条件

• 转到1.21或更高版本
• 访问Giant Swarm管理集群
• 用于身份验证的有效kubeconfig

从源头构建

# 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

用法

运行服务器

默认情况下，服务器使用stdio传输运行：

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

# Or if installed
mcp-giantswarm-apps

配置

默认情况下，服务器使用您当前的kubeconfig上下文。您可以指定其他上下文：

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

与AI助手集成

要与Claude Desktop或其他MCP兼容客户端一起使用，请在配置中添加：

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

可用工具

应用程序管理

• app_list -列出带有过滤选项的Giant Swarm应用程序
• app_get -获取特定应用程序的详细信息
• app_create -创建一个新的Giant Swarm应用程序
• app_update -更新现有应用程序
• app_delete -删除应用程序

目录管理

• catalog_list -列出可用的应用程序目录
• catalog_get -获取详细的目录信息
• catalog_refresh -刷新目录条目
• catalog_search -跨目录搜索应用程序

应用程序目录条目

• appcatalogentry_list -从目录中列出应用程序
• appcatalogentry_get -获取详细的应用程序信息
• appcatalogentry_versions -列出可用版本
• appcatalogentry_search -搜索目录条目

配置管理

• config_get -获取应用程序配置
• config_create -创建新配置
• config_update -更新配置
• config_values -获取配置值

组织管理

• organization_list -列出组织
• organization_namespaces -列出组织命名空间
• organization_info -获取命名空间详细信息
• organization_validate_access -检查访问权限

集群管理（CAPI）

• cluster_list -列出可用的工作负载集群
• cluster_get -获取详细的集群信息
• cluster_apps -列出部署到特定集群的应用程序

系统工具

• health -检查服务器和连接健康状况
• kubernetes_contexts -列出可用上下文

可用资源

服务器公开了各种资源：

• app://{namespace}/{name} -应用程序详细信息和状态
• catalog://{name} -目录信息
• config://{namespace}/{app}/values -应用程序配置

使用示例

列出工作负载集群

# 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

运行测试

make test

贡献

请看 贡献.md 作为指导方针。

许可证

此项目根据Apache许可证2.0获得许可-请参阅 许可证 文件以获取详细信息。

支持

有关问题和功能请求，请使用 .