# Mcp Server Operator

> MCP server from opendatahub-io/mcp-server-operator.

- **Type:** MCP server
- **Install:** `agentstack add mcp-opendatahub-io-mcp-server-operator`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [opendatahub-io](https://agentstack.voostack.com/s/opendatahub-io)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [opendatahub-io](https://github.com/opendatahub-io)
- **Source:** https://github.com/opendatahub-io/mcp-server-operator

## Install

```sh
agentstack add mcp-opendatahub-io-mcp-server-operator
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MCP Server Operator

The **MCP Server Operator** manages the lifecycle of MCP (Model Context Protocol) Servers on OpenShift Clusters. It leverages a Custom Resource Definition (CRD) Called `MCPServer`, allowing users to specify the MCP server image and runtime arguments for a custom MCP server deployment.

## Features
- Deploy and manages MCP server instances via CRDs
- Supports custom container images and runtime arguments
- Compatible with Openshift clusters
- Includes both end-to-end test and unit tests.

## Table of Contents
- [Project Overview](#mcp-server-operator)
- [Features](#features)
- [Usage](#usage)
    - [Prerequisites](#prerequisites)
    - [Installation](#installation)
    - [Running the operator locally](#running-the-operator-locally)
    - [Running the operator on a cluster](#running-the-operator-on-a-cluster)
    - [Making an MCP Server instance](#making-an-mcp-server-instance)
    - [Uninstalling the operator and cleaning the cluster](#uninstalling-the-operator-and-cleaning-the-cluster)
- [Developer Guide](#developer-guide)
  - [Pre-requisites](#pre-requisites)
  - [Run tests](#run-tests)
  - [Contributing](#contributing)

## Usage

### Prerequisites

Before installation, you will need the following to run the operator:
- An **OpenShift Cluster** (ROSA, OSD, CRC) or compatible Kubernetes cluster
- A **container engine** (`podman` or `docker`)
- The OpenShift CLI tool: `oc`
- Sufficient permissions to install CRDs and deploy operators

### Installation

Before doing any of these steps, ensure that you are logged into your cluster if using one:
```
oc login --token= --server=
```

After logging into your cluster, clone the repository and then swap to the mcp-server-operator folder:
```
git clone https://github.com/opendatahub-io/mcp-server-operator.git
```
```
cd mcp-server-operator
```

Next, set the environment variables:
```
export IMG=//mcp-server-operator:
```

Afterward, build the image:
```
CONTAINER_TOOL={docker|podman} IMG=$IMG make build
```

Then, install the necessary CRDs:
```
make install
```

### Running the Operator Locally

```
make run
```

### Running the Operator on a Cluster

```
make deploy IMG=$IMG
```

### Making an MCP Server Instance

The following is an example on how to create an MCPServer, ensure that the text in brackets is replaced with the appropriate information before running the command.

```
cat 
  namespace: mcp-server-operator-system
spec:
  image: 
  args:
    - 
    - 
  command:
    - 
    - 
EOF
```

**Field Descriptions**
- `image`: Container image for the MCP server.
- `args`: (Optional) List of runtime arguments to be passed to the MCP server container.
- `command`: (Optional) List for the entrypoint command to be passed to the MCP server container.

### Uninstalling the operator and cleaning the cluster
Firstly, delete the MCPServer object from the cluster using the following command:
```
oc delete mcpserver -n mcp-server-operator-system [name]
```

Next is to uninstall the operator, which can be done by simply running the command below.
```
make undeploy
```

## Developer Guide

### Pre-requisites
* `Go 1.23`
* `Kubebuilder`

### Run Tests

To run unit tests, run:
```
make test
```

To run end-to-end tests, run:
```
make test-e2e
```

### Contributing

Contributions are welcome! Please refer to our [contributing guidelines](https://github.com/opendatahub-io/opendatahub-community/blob/main/contributing.md).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [opendatahub-io](https://github.com/opendatahub-io)
- **Source:** [opendatahub-io/mcp-server-operator](https://github.com/opendatahub-io/mcp-server-operator)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-opendatahub-io-mcp-server-operator
- Seller: https://agentstack.voostack.com/s/opendatahub-io
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.