Velero

MCP for velero

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "benzaidfoued-velero-mcp": {
      "command": "python",
      "args": [
        "-m",
        "velero_mcp_server.server"
      ],
      "env": {
        "KUBECONFIG": "path/to/kubeconfig",
        "VELERO_NAMESPACE": "velero"
      }
    }
  }
}

You can access Velero backup and schedule data inside a Kubernetes cluster through a read-only MCP server. This enables AI agents and automation to inspect Velero resources safely, generate manifests, and query state without making changes to your cluster.

How to use

Set up a local MCP client that communicates with the Velero MCP Server in stdio mode. You will run a local Python process that exposes a read-only MCP API to your AI tooling. Use the available MCP endpoints to list backups, inspect schedules, and generate safe YAML manifests.

How to install

Prerequisites: you need Python 3.10 or newer and a Python virtual environment. Ensure you have access to your Kubernetes cluster and Velero namespace.

Install steps:

# 1) Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate    # On Windows use: .venv\Scripts\activate

# 2) Install dependencies
pip install -r requirements.txt

# 3) Install the MCP server package
pip install .

Running the server

Start the Velero MCP Server in stdio mode. This runs as a local process that your MCP client communicates with directly.

python -m velero_mcp_server.server

Available tools

list_velero_backups

Returns a list of Velero Backup CRs.

get_velero_backup

Returns a detailed structured backup object.

list_velero_schedules

Lists Velero Schedule CRs including cron, paused state, and last backup.

generate_velero_backup_yaml

Generates read-only YAML for a Velero Backup.