Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kagent-dev--kmcp/badge.svg)](/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

i

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)

  1. <!-- markdownlint-disable MD033 -->
  2. <div align="center">
  3. <picture>
  4. <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/kagent-dev/kmcp/main/img/kmcp-logo-dark.svg" alt="kmcp" width="400">
  5. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/kagent-dev/kmcp/main/img/kmcp-logo-light.svg" alt="kmcp" width="400">
  6. <img alt="kmcp" src="https://raw.githubusercontent.com/kagent-dev/kmcp/main/img/kmcp-logo-light.svg">
  7. </picture>
  8. <div>
  9. <a href="https://github.com/kagent-dev/kmcp/releases">
  10. <img src="https://img.shields.io/github/v/release/kagent-dev/kmcp?style=flat&label=Latest%20version" alt="Release">
  11. </a>
  12. <a href="https://github.com/kagent-dev/kmcp/actions/workflows/tag.yaml">
  13. <img src="https://github.com/kagent-dev/kmcp/actions/workflows/tag.yaml/badge.svg" alt="Build Status" height="20">
  14. </a>
  15. <a href="https://opensource.org/licenses/Apache-2.0">
  16. <img src="https://img.shields.io/badge/License-Apache2.0-brightgreen.svg?style=flat" alt="License: Apache 2.0">
  17. </a>
  18. <a href="https://github.com/kagent-dev/kmcp">
  19. <img src="https://img.shields.io/github/stars/kagent-dev/kmcp.svg?style=flat&logo=github&label=Stars" alt="Stars">
  20. </a>
  21. <a href="https://discord.gg/Fu3k65f2k3">
  22. <img src="https://img.shields.io/discord/1346225185166065826?style=flat&label=Join%20Discord&color=6D28D9" alt="Discord">
  23. </a>
  24. </div>
  25. <h3>A development platform and control plane for the Model Context Protocol (MCP)</h3>
  26. <p><i>MCP connectivity simplified, bring MCP service prototypes into production</i></p>
  27. </div>
  28. <!-- markdownlint-enable MD033 -->
  29. ---
  30. <!-- markdownlint-disable MD033 -->
  31. <table align="center">
  32. <tr>
  33. <td>
  34. <a href="#getting-started"><b><i>Getting Started</i></b></a>
  35. </td>
  36. <td>
  37. <a href="#from-prototype-to-production"><b><i>Prototype to Production</i><b></a>
  38. </td>
  39. <td>
  40. <a href="#technical-details"><b><i>Technical Details</i></b></a>
  41. </td>
  42. <td>
  43. <a href="#get-involved"><b><i>Get Involved</i></b></a>
  44. </td>
  45. <td>
  46. <a href="#reference"><b><i>Reference</i></b></a>
  47. </td>
  48. </tr>
  49. </table>
  50. <!-- markdownlint-disable MD033 -->
  51. ---
  52. ## Why kMCP?
  53. Prototyping MCP services in isolation is quick and fun, but production adoption introduces many challenges:
  54. - **Ad-hoc scaffolding** - Configuring the MCP server, integrating it in Kubernetes, and operating it at enterprise scale
  55. - **Transport fragmentation** – Supporting multiple protocols (HTTP, WebSocket, SSE, etc.) requires custom maintenance
  56. - **Disconnected context** - Enforcing consistent security, observability, and governance for agent-to-tool communication
  57. **_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._**
  58. ## Getting Started
  59. Install the kmcp CLI on your local machine.
  60. ```bash
  61. 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
  62. ```
  63. Verify that the kmcp CLI is installed.
  64. ```bash
  65. kmcp --help
  66. ```
  67. <img src="img/cli-help-nov-25.png" alt="kmcp cli help text" width="800">
  68. _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)_
  69. ## From Prototype to Production
  70. <img src="img/kmcp.png" alt="kmcp architecture" width="800">
  71. MCP connectivity affects everyone in an organization. Below are some common quickstart journeys that you may experience:
  72. - [Your first MCP service prototype](https://kagent.dev/docs/kmcp/develop)
  73. - [AI/ML Engineer packaging an existing prototype](https://kagent.dev/docs/kmcp/deploy/server#option-1-deploy-an-mcp-server-with-npx-or-uvx)
  74. - [DevOps engineer building MCP infrastructure in Kubernetes](https://kagent.dev/docs/kmcp/deploy/server#option-2-build-and-deploy-an-mcp-server)
  75. ## Technical Details
  76. `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).
  77. ### Core Components
  78. - **[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.
  79. - **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.
  80. - **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.
  81. ### Core Principles
  82. - ✨ **Rapid scaffolding** with support for FastMCP (Python) and MCP Go SDK
  83. - 🚀 **One-command deployment** to Kubernetes with pre-configured Transport Adapters
  84. - 🔄 **Consistent workflow** from local development to production
  85. - 🌐 **Built-in transport support** for HTTP, WebSocket, and Server-Sent Events
  86. - ☸️ **Kubernetes-native** using Custom Resource Definitions (CRDs)
  87. - 🔐 **Secrets management** integrated with Kubernetes secrets
  88. ## Get Involved
  89. _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)_
  90. There are many ways to get involved:
  91. - 🐛 [Report bugs and issues](https://github.com/kagent-dev/kmcp/issues/)
  92. - 💡 [Suggest new features](https://github.com/kagent-dev/kmcp/issues/)
  93. - 📖 [Improve documentation](https://github.com/kagent-dev/website/)
  94. - 🔧 [Submit pull requests](/CONTRIBUTING.md)
  95. - ⭐ Star the repository
  96. - 💬 [Help others in Discord](https://discord.gg/Fu3k65f2k3)
  97. - 💬 [Join the kagent community meetings](https://calendar.google.com/calendar/u/0?cid=Y183OTI0OTdhNGU1N2NiNzVhNzE0Mjg0NWFkMzVkNTVmMTkxYTAwOWVhN2ZiN2E3ZTc5NDA5Yjk5NGJhOTRhMmVhQGdyb3VwLmNhbGVuZGFyLmdvb2dsZS5jb20)
  98. - 🤝 [Share tips in the CNCF #kagent slack channel](https://cloud-native.slack.com/archives/C08ETST0076)
  99. - 🔒 [Report security concerns](SECURITY.md)
  100. Thanks to all contributors!
  101. <a href="https://github.com/kagent-dev/kmcp/graphs/contributors">
  102. <img alt="kmcp contributors" src="https://contrib.rocks/image?repo=kagent-dev/kmcp" />
  103. </a>
  104. ## Reference
  105. ### Resources
  106. - [kMCP documentation](https://kagent.dev/docs/kmcp)
  107. ### Ecosystem Resources
  108. - [Model Context Protocol Specification](https://spec.modelcontextprotocol.io/)
  109. - [MCP Documentation](https://modelcontextprotocol.io/)
  110. - [Anthropic's MCP Announcement](https://www.anthropic.com/news/model-context-protocol)
  111. - [FastMCP Python Documentation](https://github.com/jlowin/fastmcp)
  112. - [MCP Go SDK](https://github.com/mark3labs/mcp-go)
  113. ### License
  114. This project is licensed under the [Apache 2.0 License.](/LICENSE)
  115. ---
  116. <div align="center">
  117. <p>Built with ❤️ by the <a href="https://github.com/kagent-dev">kagent team</a> </p>
  118. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.