my-cmp-server

A FastMCP server that wraps a REST API as MCP tools.

Overview

This is a 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

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

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:

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