{"id":30015121,"url":"https://github.com/kagent-dev/kmcp","last_synced_at":"2025-08-05T18:57:35.951Z","repository":{"id":307342665,"uuid":"1012526371","full_name":"kagent-dev/kmcp","owner":"kagent-dev","description":"CLI tool and Kubernetes Controller for building, testing and deploying MCP servers","archived":false,"fork":false,"pushed_at":"2025-07-30T19:32:01.000Z","size":418,"stargazers_count":25,"open_issues_count":11,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-30T20:22:15.736Z","etag":null,"topics":["cli","kubernetes","mcp"],"latest_commit_sha":null,"homepage":"https://kagent.dev/docs/kmcp","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kagent-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-02T13:17:25.000Z","updated_at":"2025-07-30T19:26:07.000Z","dependencies_parsed_at":"2025-07-30T20:23:58.403Z","dependency_job_id":"beb9aa97-da69-45be-882b-929804d00bda","html_url":"https://github.com/kagent-dev/kmcp","commit_stats":null,"previous_names":["kagent-dev/kmcp"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/kagent-dev/kmcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kagent-dev%2Fkmcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kagent-dev%2Fkmcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kagent-dev%2Fkmcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kagent-dev%2Fkmcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kagent-dev","download_url":"https://codeload.github.com/kagent-dev/kmcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kagent-dev%2Fkmcp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268955235,"owners_count":24335208,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-05T02:00:12.334Z","response_time":2576,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","kubernetes","mcp"],"created_at":"2025-08-05T18:57:33.177Z","updated_at":"2025-08-05T18:57:35.905Z","avatar_url":"https://github.com/kagent-dev.png","language":"Go","funding_links":[],"categories":["📚 Projects (1974 total)"],"sub_categories":["MCP Servers"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/kagent-dev/kmcp/main/img/kmcp-logo-dark.svg\" alt=\"kmcp\" width=\"400\"\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/kagent-dev/kmcp/main/img/kmcp-logo-light.svg\" alt=\"kmcp\" width=\"400\"\u003e\n    \u003cimg alt=\"kmcp\" src=\"https://raw.githubusercontent.com/kagent-dev/kmcp/main/img/kmcp-logo-light.svg\"\u003e\n  \u003c/picture\u003e\n  \u003cdiv\u003e\n    \u003ca href=\"https://github.com/kagent-dev/kmcp/releases\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/v/release/kagent-dev/kmcp?style=flat\u0026label=Latest%20version\" alt=\"Release\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/kagent-dev/kmcp/actions/workflows/tag.yaml\"\u003e\n      \u003cimg src=\"https://github.com/kagent-dev/kmcp/actions/workflows/tag.yaml/badge.svg\" alt=\"Build Status\" height=\"20\"\u003e\n    \u003c/a\u003e\n      \u003ca href=\"https://opensource.org/licenses/Apache-2.0\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/License-Apache2.0-brightgreen.svg?style=flat\" alt=\"License: Apache 2.0\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/kagent-dev/kmcp\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/stars/kagent-dev/kmcp.svg?style=flat\u0026logo=github\u0026label=Stars\" alt=\"Stars\"\u003e\n    \u003c/a\u003e\n      \u003ca href=\"https://discord.gg/Fu3k65f2k3\"\u003e\n      \u003cimg src=\"https://img.shields.io/discord/1346225185166065826?style=flat\u0026label=Join%20Discord\u0026color=6D28D9\" alt=\"Discord\"\u003e\n    \u003c/a\u003e\n  \u003c/div\u003e\n\u003c/div\u003e\n\n\n# kmcp\n\n**A development platform and control plane for the Model Context Protocol (MCP)**\n\n`kmcp` is a comprehensive toolkit for building, deploying, and managing Model Context Protocol (MCP) servers. It provides a command-line interface (CLI) for local development and a Kubernetes controller for production deployments, enabling a seamless transition from development to production.\n\n## Core Concepts\n\n`kmcp` is composed of three primary components that work together to provide a complete MCP server-management solution:\n\n1.  **The `kmcp` CLI**: The CLI is your primary tool for local development. It allows you to scaffold new MCP projects, manage tools, build container images, and run your MCP server locally for testing and development.\n\n2.  **The Kubernetes Controller**: The `kmcp` controller runs in your Kubernetes cluster and manages the lifecycle of your MCP server deployments. It uses a Custom Resource Definition (CRD) to define MCP servers as native Kubernetes objects, allowing you to manage them with familiar `kubectl` commands.\n\n3.  **The Agent Gateway**: In a Kubernetes environment, `kmcp` deploys your MCP server behind a dedicated [Agent Gateway](https://www.solo.io/press-releases/solo-io-launches-agent-gateway-and-introduces-agent-mesh/). `kmcp` acts as a control plane for this gateway, configuring it to provide enterprise-grade features for your MCP server without requiring any changes to your code. These features include:\n    -   Rate limiting\n    -   Authorization and Authentication (AuthZ/N)\n    -   Observability (tracing, logging, and metrics)\n    -   Health checks\n    -   TLS Termination\n\n## Features (CLI Command Overview)\n\nThe `kmcp` CLI provides a set of commands to manage the entire lifecycle of your MCP server:\n\n-   `kmcp init`: Scaffolds a new MCP server project. Supported frameworks include [FastMCP](https://github.com/jlowin/fastmcp) for Python and the [official MCP Go SDK](https://github.com/mark3labs/mcp-go) for Go.\n-   `kmcp add-tool`: Adds a new tool to your project, automatically handling boilerplate and registration.\n-   `kmcp run`: Runs the MCP server in a local development environment.\n-   `kmcp build`: Builds a Docker image for your MCP server.\n-   `kmcp install`: Installs the `kmcp` controller and CRDs on a Kubernetes cluster.\n-   `kmcp deploy`: Deploys your MCP server to a Kubernetes cluster, placing it behind a pre-configured Agent Gateway.\n-   `kmcp secrets`: Manages secrets for your MCP server deployment in Kubernetes.\n\n## Architecture\n\nThe following diagram illustrates the `kmcp` workflow, from local development to a production deployment in Kubernetes:\n\n```mermaid\ngraph TD\n    subgraph Local Development\n        A[Developer] -- kmcp init --\u003e B(MCP Project);\n        B -- kmcp add-tool --\u003e B;\n        B -- kmcp run --\u003e C{Local MCP Server};\n        A -- Edits Code --\u003e B;\n    end\n\n    subgraph Production Deployment\n        B -- kmcp build --\u003e D[Docker Image];\n        D -- kmcp deploy --\u003e E(Kubernetes Cluster);\n    end\n\n    subgraph Kubernetes Cluster\n        F[kmcp Controller] -- Manages --\u003e G(MCP Server CRD);\n        G -- Deploys --\u003e H[Agent Gateway];\n        H -- Proxies Traffic --\u003e I[MCP Server Pod];\n    end\n\n    A -- Interacts with --\u003e C;\n    E -- Contains --\u003e F;\n    E -- Contains --\u003e G;\n    E -- Contains --\u003e H;\n    E -- Contains --\u003e I;\n```\n\n## Get started\n\n- [Quick Start](https://kagent.dev/docs/kmcp/quickstart)\n- [Installation Guide](https://kagent.dev/docs/kmcp/deploy/install-controller)\n\n## Documentation\n\nThe kmcp documentation is available at [kagent.dev/docs/kmcp](https://kagent.dev/docs/kmcp).\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\nThanks to all contributors!\n\n\u003ca href=\"https://github.com/kagent-dev/kmcp/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=kagent-dev/kmcp\" /\u003e\n\u003c/a\u003e\n\n## 📈 Star History\n\n\u003ca href=\"https://www.star-history.com/#kagent-dev/kmcp\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=kagent-dev/kmcp\u0026type=Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=kagent-dev/kmcp\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star history of kagent-dev/kmcp over time\" src=\"https://api.star-history.com/svg?repos=kagent-dev/kmcp\u0026type=Date\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n## 📄 License\n\nCopyright 2025.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\n## 🔗 Resources\n\n- [Model Context Protocol Specification](https://spec.modelcontextprotocol.io/)\n- [MCP Documentation](https://modelcontextprotocol.io/)\n- [Anthropic's MCP Announcement](https://www.anthropic.com/news/model-context-protocol)\n- [FastMCP Python Documentation](https://github.com/jlowin/fastmcp)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkagent-dev%2Fkmcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkagent-dev%2Fkmcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkagent-dev%2Fkmcp/lists"}