# my-cmp-server
A FastMCP server that wraps a REST API as MCP tools.

## Overview

This is a [FastMCP](https://github.com/jlowin/fastmcp) server that exposes a 
REST API as a set of MCP (Model Context Protocol) tools. AI agents and LLMs can
invoke these tools to interact with the upstream API.

### Prerequisites

- Python 3.11+
- The upstream API running at `https://localhost:8080`

### Setup

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

### Run

```bash
python3 mcp_server.py
```
The server starts on `http://0.0.0.0:8000/mcp` using the 
streamable HTTP transport.

## Container Build

```bash
docker build -t my-cmp-server .
docker run -p 8000:8000 my-cmp-server
```

## CI/CD with Pipelines as Code (Tekton)

This project uses **Pipelines as Code** (PAC) for fully automated CI/CD on
Openshift. No manual setup is required -- every push to `main` automatically
builds the container image and deploys to Openshift.

The pipeline definition lives in `.tekton/push.yaml` and performs:

1. **Clone** -- fetches the repository source
2. **Build** -- biulds the container image with buildah and pushes to the 
   OpenShift internal registry
3. **Deploy** -- applies the deployment manifests and rolls out the new version.

### How it works

A GitHub webhook (created automatically by the RHDH template) sends push events
to the Pipelines as Code controller on Openshift. PAC reads `.tekton/push.yaml`
from the repo and creates a PipelineRun automatically.

### Manual Deployment (without pipeline)

Apply the included manifests directly:

```bash
oc apply -f deploy/deployment.yaml
```

This creates a Deployment, Service, and Route in the `mcp-servers`
namespace. The Route provides a TLS-terminated public endpoint.

## Customization

Edit `mcp_server.py` to replace the placeholder tools (`list_items`,
`get_item`,`create_item`) with tools that match your actual API endpoints.
Each `@mcp.tool` function maps to one REST endpoint:

| HTTP Method | MCP Tool Pattern |
|-------------|-----------------|
| GET (list)  | Tool that returns a list of resources |
| GET (by id) | Tool that returns a single resource |
| POST        | Tool that creates a resource |
| PATCH / PUT | Tool that updates a resource |
| DELETE      | Tool that removes a resource |