kmcp
CLI tool and Kubernetes Controller for building, testing and deploying MCP servers
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/kagent-dev--kmcp)HTML
<a href="/listings/kagent-dev--kmcp"><img src="/api/listings/kagent-dev--kmcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
Install the kmcp CLI on your local machine.
curl -fsSL https://raw.githubusercontent.com/kagent-dev/kmcp/refs/heads/main/scripts/get-kmcp.sh | bash
Verify that the kmcp CLI is installed.
kmcp --help
_You're ready to go! Continue on to [From Prototype to Production](#from-prototype-to-production) or explore our docs at [kagent.dev/docs/kmcp](https://kagent.dev/docs/kmcp)_
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 156 lines · 1 finding marked
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <!-- markdownlint-disable MD033 -->
- <div align="center">
- <picture>
- <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/kagent-dev/kmcp/main/img/kmcp-logo-dark.svg" alt="kmcp" width="400">
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/kagent-dev/kmcp/main/img/kmcp-logo-light.svg" alt="kmcp" width="400">
- <img alt="kmcp" src="https://raw.githubusercontent.com/kagent-dev/kmcp/main/img/kmcp-logo-light.svg">
- </picture>
- <div>
- <a href="https://github.com/kagent-dev/kmcp/releases">
- <img src="https://img.shields.io/github/v/release/kagent-dev/kmcp?style=flat&label=Latest%20version" alt="Release">
- </a>
- <a href="https://github.com/kagent-dev/kmcp/actions/workflows/tag.yaml">
- <img src="https://github.com/kagent-dev/kmcp/actions/workflows/tag.yaml/badge.svg" alt="Build Status" height="20">
- </a>
- <a href="https://opensource.org/licenses/Apache-2.0">
- <img src="https://img.shields.io/badge/License-Apache2.0-brightgreen.svg?style=flat" alt="License: Apache 2.0">
- </a>
- <a href="https://github.com/kagent-dev/kmcp">
- <img src="https://img.shields.io/github/stars/kagent-dev/kmcp.svg?style=flat&logo=github&label=Stars" alt="Stars">
- </a>
- <a href="https://discord.gg/Fu3k65f2k3">
- <img src="https://img.shields.io/discord/1346225185166065826?style=flat&label=Join%20Discord&color=6D28D9" alt="Discord">
- </a>
- </div>
- <h3>A development platform and control plane for the Model Context Protocol (MCP)</h3>
- <p><i>MCP connectivity simplified, bring MCP service prototypes into production</i></p>
- </div>
- <!-- markdownlint-enable MD033 -->
- ---
- <!-- markdownlint-disable MD033 -->
- <table align="center">
- <tr>
- <td>
- <a href="#getting-started"><b><i>Getting Started</i></b></a>
- </td>
- <td>
- <a href="#from-prototype-to-production"><b><i>Prototype to Production</i><b></a>
- </td>
- <td>
- <a href="#technical-details"><b><i>Technical Details</i></b></a>
- </td>
- <td>
- <a href="#get-involved"><b><i>Get Involved</i></b></a>
- </td>
- <td>
- <a href="#reference"><b><i>Reference</i></b></a>
- </td>
- </tr>
- </table>
- <!-- markdownlint-disable MD033 -->
- ---
- ## Why kMCP?
- Prototyping MCP services in isolation is quick and fun, but production adoption introduces many challenges:
- - **Ad-hoc scaffolding** - Configuring the MCP server, integrating it in Kubernetes, and operating it at enterprise scale
- - **Transport fragmentation** – Supporting multiple protocols (HTTP, WebSocket, SSE, etc.) requires custom maintenance
- - **Disconnected context** - Enforcing consistent security, observability, and governance for agent-to-tool communication
- **_We believe teams who have build MCP services should not experience friction when bringing those services to production. kMCP is designed to make MCP connectivity simple._**
- ## Getting Started
- Install the kmcp CLI on your local machine.
- ```bash
- curl -fsSL https://raw.githubusercontent.com/kagent-dev/kmcp/refs/heads/main/scripts/get-kmcp.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 70 on GitHub
- ```
- Verify that the kmcp CLI is installed.
- ```bash
- kmcp --help
- ```
- <img src="img/cli-help-nov-25.png" alt="kmcp cli help text" width="800">
- _You're ready to go! Continue on to [From Prototype to Production](#from-prototype-to-production) or explore our docs at [kagent.dev/docs/kmcp](https://kagent.dev/docs/kmcp)_
- ## From Prototype to Production
- <img src="img/kmcp.png" alt="kmcp architecture" width="800">
- MCP connectivity affects everyone in an organization. Below are some common quickstart journeys that you may experience:
- - [Your first MCP service prototype](https://kagent.dev/docs/kmcp/develop)
- - [AI/ML Engineer packaging an existing prototype](https://kagent.dev/docs/kmcp/deploy/server#option-1-deploy-an-mcp-server-with-npx-or-uvx)
- - [DevOps engineer building MCP infrastructure in Kubernetes](https://kagent.dev/docs/kmcp/deploy/server#option-2-build-and-deploy-an-mcp-server)
- ## Technical Details
- `kmcp` is a comprehensive toolkit for building, deploying, and managing Model Context Protocol (MCP) servers. For a more detailed breakdown of using kmcp in your workflow, check out our [achitecture overview](/devel/architecture/workflow.md).
- ### Core Components
- - **[CLI](/pkg/cli/README.md)** is your primary tool for development. It allows you to scaffold new MCP projects, manage tools, build container images, and run your MCP server locally for testing and development.
- - **Controller**: Manages the lifecycle of your MCP server deployments in your Kubernetes cluster. It uses a Custom Resource Definition (CRD) to define MCP servers as native Kubernetes objects, allowing you to manage them with familiar `kubectl` commands.
- - **Transport Adapater** - Fronts the MCP server and provides features such as external traffic routing for your MCP server with support for multiple transport protocols without requiring any changes to your code.
- ### Core Principles
- - ✨ **Rapid scaffolding** with support for FastMCP (Python) and MCP Go SDK
- - 🚀 **One-command deployment** to Kubernetes with pre-configured Transport Adapters
- - 🔄 **Consistent workflow** from local development to production
- - 🌐 **Built-in transport support** for HTTP, WebSocket, and Server-Sent Events
- - ☸️ **Kubernetes-native** using Custom Resource Definitions (CRDs)
- - 🔐 **Secrets management** integrated with Kubernetes secrets
- ## Get Involved
- _We welcome contributions! Contributors are expected to [respect the kagent Code of Conduct](https://github.com/kagent-dev/community/blob/main/CODE-OF-CONDUCT.md)_
- There are many ways to get involved:
- - 🐛 [Report bugs and issues](https://github.com/kagent-dev/kmcp/issues/)
- - 💡 [Suggest new features](https://github.com/kagent-dev/kmcp/issues/)
- - 📖 [Improve documentation](https://github.com/kagent-dev/website/)
- - 🔧 [Submit pull requests](/CONTRIBUTING.md)
- - ⭐ Star the repository
- - 💬 [Help others in Discord](https://discord.gg/Fu3k65f2k3)
- - 💬 [Join the kagent community meetings](https://calendar.google.com/calendar/u/0?cid=Y183OTI0OTdhNGU1N2NiNzVhNzE0Mjg0NWFkMzVkNTVmMTkxYTAwOWVhN2ZiN2E3ZTc5NDA5Yjk5NGJhOTRhMmVhQGdyb3VwLmNhbGVuZGFyLmdvb2dsZS5jb20)
- - 🤝 [Share tips in the CNCF #kagent slack channel](https://cloud-native.slack.com/archives/C08ETST0076)
- - 🔒 [Report security concerns](SECURITY.md)
- Thanks to all contributors!
- <a href="https://github.com/kagent-dev/kmcp/graphs/contributors">
- <img alt="kmcp contributors" src="https://contrib.rocks/image?repo=kagent-dev/kmcp" />
- </a>
- ## Reference
- ### Resources
- - [kMCP documentation](https://kagent.dev/docs/kmcp)
- ### Ecosystem Resources
- - [Model Context Protocol Specification](https://spec.modelcontextprotocol.io/)
- - [MCP Documentation](https://modelcontextprotocol.io/)
- - [Anthropic's MCP Announcement](https://www.anthropic.com/news/model-context-protocol)
- - [FastMCP Python Documentation](https://github.com/jlowin/fastmcp)
- - [MCP Go SDK](https://github.com/mark3labs/mcp-go)
- ### License
- This project is licensed under the [Apache 2.0 License.](/LICENSE)
- ---
- <div align="center">
- <p>Built with ❤️ by the <a href="https://github.com/kagent-dev">kagent team</a> </p>
- </div>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.