mcp-server

Tekton Model Context Protocol server

This project is in its early stages, and the README is currently minimal.

This project provides a Model Context Protocol (MCP) server for the tektoncd projects. It initially focuses on tektoncd/pipeline objects but will over time add support for other tektoncd projects.

Tools

List Operations

list_pipelines – List Pipelines in the Cluster with Filtering Options

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

list_pipelineruns – List PipelineRuns in the Cluster with Filtering Options

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

list_tasks – List Tasks in the Cluster with Filtering Options

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

list_taskruns – List TaskRuns in the Cluster with Filtering Options

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

list_stepactions – List Step Actions in the Cluster with Filtering Options

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

Create Operations

create_pipeline – Create a new Pipeline from YAML definition

• namespace: Namespace where the Pipeline will be created (string, optional, default: "default")
• yaml: YAML definition of the Pipeline (string, required)

create_task – Create a new Task from YAML definition

• namespace: Namespace where the Task will be created (string, optional, default: "default")
• yaml: YAML definition of the Task (string, required)

create_pipelinerun – Create a new PipelineRun from YAML definition or generate from Pipeline

• namespace: Namespace where the PipelineRun will be created (string, optional, default: "default")
• yaml: YAML definition of the PipelineRun (string, optional)
• generateName: Generate name prefix for the PipelineRun (string, optional)

create_taskrun – Create a new TaskRun from YAML definition

• namespace: Namespace where the TaskRun will be created (string, optional, default: "default")
• yaml: YAML definition of the TaskRun (string, optional)
• generateName: Generate name prefix for the TaskRun (string, optional)

Get Operations

get_pipeline – Get a specific Pipeline by name

• name: Name of the Pipeline to get (string, required)
• namespace: Namespace of the Pipeline (string, optional, default: "default")
• output: Output format - json or yaml (string, optional, default: "yaml")

get_task – Get a specific Task by name

• name: Name of the Task to get (string, required)
• namespace: Namespace of the Task (string, optional, default: "default")
• output: Output format - json or yaml (string, optional, default: "yaml")

get_pipelinerun – Get a specific PipelineRun by name

• name: Name of the PipelineRun to get (string, required)
• namespace: Namespace of the PipelineRun (string, optional, default: "default")
• output: Output format - json or yaml (string, optional, default: "yaml")

get_taskrun – Get a specific TaskRun by name

• name: Name of the TaskRun to get (string, required)
• namespace: Namespace of the TaskRun (string, optional, default: "default")
• output: Output format - json or yaml (string, optional, default: "yaml")

get_taskrun_logs - Get the logs for a given TaskRun

• name: Name or reference of the TaskRun to get logs from (string, required)
• namespace: Namespace where the TaskRun is located (string, optional, default: "default")

Update Operations

update_pipeline – Update an existing Pipeline

• name: Name of the Pipeline to update (string, required)
• namespace: Namespace of the Pipeline (string, optional, default: "default")
• yaml: Updated YAML definition of the Pipeline (string, required)

update_task – Update an existing Task

• name: Name of the Task to update (string, required)
• namespace: Namespace of the Task (string, optional, default: "default")
• yaml: Updated YAML definition of the Task (string, required)

patch_pipeline – Apply a JSON patch to an existing Pipeline

• name: Name of the Pipeline to patch (string, required)
• namespace: Namespace of the Pipeline (string, optional, default: "default")
• patch: JSON patch to apply to the Pipeline (string, required)

Delete Operations

delete_pipeline – Delete a Pipeline

• name: Name of the Pipeline to delete (string, required)
• namespace: Namespace of the Pipeline (string, optional, default: "default")

delete_task – Delete a Task

• name: Name of the Task to delete (string, required)
• namespace: Namespace of the Task (string, optional, default: "default")

delete_pipelinerun – Delete a PipelineRun

• name: Name of the PipelineRun to delete (string, required)
• namespace: Namespace of the PipelineRun (string, optional, default: "default")

delete_taskrun – Delete a TaskRun

• name: Name of the TaskRun to delete (string, required)
• namespace: Namespace of the TaskRun (string, optional, default: "default")

delete_all_pipelineruns – Delete multiple PipelineRuns based on selectors

• namespace: Namespace to delete PipelineRuns from (string, optional, default: "default")
• labelSelector: Label selector to filter PipelineRuns to delete (string, optional)
• fieldSelector: Field selector to filter PipelineRuns to delete (string, optional)

Start/Restart Operations

start_pipeline – Start a Pipeline

• name: Name or reference of the Pipeline to start (string, required)
• namespace: Namespace where the Pipeline is located (string, optional, default: "default")

start_task – Start a Task

• name: Name or reference of the Task to start (string, required)
• namespace: Namespace where the Task is located (string, optional, default: "default")

restart_pipelinerun – Restart a PipelineRun

• name: Name or reference of the PipelineRun to restart (string, required)
• namespace: Namespace where the PipelineRun is located (string, optional, default: "default")

restart_taskrun – Restart a TaskRun

• name: Name or reference of the TaskRun to restart (string, required)
• namespace: Namespace where the TaskRun is located (string, optional, default: "default")

Artifact Hub Integration

The MCP server provides integration with Artifact Hub to discover, install, and trigger Tekton tasks and pipelines from the community catalog.

Artifact Hub Discovery Operations

list_artifacthub_tasks – List Tekton Tasks from Artifact Hub

• query: Search query to filter tasks (string, optional)
• limit: Maximum number of results to return (integer, optional, default: 20)

list_artifacthub_pipelines – List Tekton Pipelines from Artifact Hub

• query: Search query to filter pipelines (string, optional)
• limit: Maximum number of results to return (integer, optional, default: 20)

Artifact Hub Installation Operations

install_artifacthub_task – Install a Tekton Task from Artifact Hub

• packageId: The Artifact Hub package ID of the task to install (string, required)
• version: Version of the task to install (string, optional)
• namespace: Namespace where the task will be installed (string, optional, default: "default")

install_artifacthub_pipeline – Install a Tekton Pipeline from Artifact Hub

• packageId: The Artifact Hub package ID of the pipeline to install (string, required)
• version: Version of the pipeline to install (string, optional)
• namespace: Namespace where the pipeline will be installed (string, optional, default: "default")

Artifact Hub Trigger Operations

trigger_artifacthub_task – Trigger a Task installed from Artifact Hub

• name: Name of the installed task to trigger (string, required)
• namespace: Namespace where the task is located (string, optional, default: "default")
• params: Parameters to pass to the task (object, optional)

trigger_artifacthub_pipeline – Trigger a Pipeline installed from Artifact Hub

• name: Name of the installed pipeline to trigger (string, required)
• namespace: Namespace where the pipeline is located (string, optional, default: "default")
• params: Parameters to pass to the pipeline (object, optional)