Back to Home
Agent-Hellboy icon

mcp-runtime

Verified Safe

by Agent-Hellboy

Overview

A self-hosted platform for deploying and managing specialized Model Context Protocol (MCP) servers, primarily for large language models within organizations, offering an internal registry and Kubernetes-native deployment.

Installation

Run Command
./bin/mcp-runtime setup

Environment Variables

  • PROVISIONED_REGISTRY_URL
  • PROVISIONED_REGISTRY_USERNAME
  • PROVISIONED_REGISTRY_PASSWORD
  • MCP_DEFAULT_INGRESS_HOST
  • MCP_OPERATOR_IMAGE

Security Notes

The project demonstrates strong security awareness, particularly in its CLI component which uses robust validators (`AllowlistBins`, `NoShellMeta`, `NoControlChars`, `PathUnder`) to mitigate command injection risks when executing external binaries like `kubectl` and `docker`. Sensitive information like registry credentials are handled securely via Kubernetes Secrets (both generic and `dockerconfigjson`), with measures to prevent exposure in shell history or temporary files. Temporary files are created using `os.CreateTemp` and properly removed. The Kubernetes operator's ClusterRole grants broad permissions (create, delete, update, patch, get, list, watch for deployments, services, ingresses, secrets, etc.), which is standard for an operator but necessitates careful review in a production environment due to the blast radius if compromised. The registry deployment's `initContainer` runs as `root` for file ownership (common for persistent volumes) but the main registry container runs as `non-root` with `allowPrivilegeEscalation: false`. User-provided `IngressAnnotations` are merged, which could theoretically allow injection of malicious ingress configurations, though standard ingress controllers often sanitize or restrict such inputs. The `zz_generated.deepcopy.go` file contains a copyright year of 2025, which is likely a minor oversight.

Similar Servers

Stats

Interest Score34
Security Score9
Cost ClassLow
Stars4
Forks2
Last Update2026-01-10

Tags

KubernetesLLM DeploymentContainer RegistryCLIOperator