kmcp

<!-- 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 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 ``` 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