Shipwright Build MCP Server

A Model Context Protocol (MCP) server for the Shipwright Build project. This server provides tools for interacting with Shipwright Build resources including Builds, BuildRuns, BuildStrategies, and ClusterBuildStrategies.

Overview

This MCP server exposes Shipwright Build functionality through standardized tools that can be consumed by MCP clients. It's designed to work with the Shipwright Build Kubernetes-native CI/CD framework for building container images from source code.

Features

Build Management

• list_builds - List builds in a namespace with filtering options
• get_build - Get detailed information about a specific build
• create_build - Create a new Build resource from source
• delete_build - Delete a Build resource

BuildRun Management

• list_buildruns - List buildruns in a namespace with filtering options
• get_buildrun - Get detailed information about a specific buildrun
• create_buildrun - Create a new BuildRun (from existing Build or inline spec)
• restart_buildrun - Restart a buildrun by creating a new one
• delete_buildrun - Delete a BuildRun resource

Strategy Management

• list_buildstrategies - List namespace-scoped build strategies with filtering options
• list_clusterbuildstrategies - List cluster-scoped build strategies with filtering options

Prerequisites

• Go 1.23 or later
• Access to a Kubernetes cluster with Shipwright Build installed
• Proper Kubernetes configuration (kubeconfig or in-cluster config)

Installation

1. Build the server:

go build -o shipwright-build-mcp-server main.go

Usage

The server runs as a standard MCP server over stdin/stdout. You can use it with any MCP client.

Running the Server

./shipwright-build-mcp-server

Example Client Configuration

Refer config.example.json in the root of this project

Available Tools

Build Tools

list_builds – List Builds in a Namespace with Filtering Options

• namespace: Namespace to list builds from (string, required)
• prefix: Name prefix to filter builds (string, optional)
• label-selector: Label selector to filter builds (string, optional)

get_build – Get a Specific Build by Name

• name: Name of the build to get (string, required)
• namespace: Namespace where the build is located (string, optional, default: "default")

create_build – Create a New Build Resource

• name: Name of the build to create (string, required)
• namespace: Namespace where the build will be created (string, optional, default: "default")
• source-type: Source type - "Git" or "OCI" (string, required)
• source-url: Source URL (Git repository or OCI image) (string, required)
• context-dir: Context directory within the source (string, optional)
• revision: Git revision (branch, tag, or commit SHA) (string, optional)
• strategy: Build strategy name (string, required)
• strategy-kind: Build strategy kind - "BuildStrategy" or "ClusterBuildStrategy" (string, optional, default: "ClusterBuildStrategy")
• output-image: Output container image reference (string, required)
• parameters: Build parameters as key-value pairs (object, optional)
• timeout: Build timeout duration, e.g. "30m", "1h" (string, optional)

delete_build – Delete a Build Resource

• name: Name of the build to delete (string, required)
• namespace: Namespace where the build is located (string, optional, default: "default")

BuildRun Tools

list_buildruns – List BuildRuns in a Namespace with Filtering Options

• namespace: Namespace to list buildruns from (string, required)
• prefix: Name prefix to filter buildruns (string, optional)
• label-selector: Label selector to filter buildruns (string, optional)

get_buildrun – Get a Specific BuildRun by Name

• name: Name of the buildrun to get (string, required)
• namespace: Namespace where the buildrun is located (string, optional, defa

... View full README on GitHub