kong README

The project's README from github.com/Kong/kong. As one markdown file: README.md.

Stars GitHub commit activity Build Status Version License Twitter Follow

Kong or Kong Gateway is a cloud-native, platform-agnostic, scalable API 𖧹 LLM 𖧹 MCP Gateway distinguished for its high performance and extensibility via plugins. It also provides advanced AI traffic capabilities with multi-LLM support, semantic security, MCP traffic security and analytics, and more.

By providing functionality for proxying, routing, load balancing, health checking, authentication (and more), Kong serves as the central layer for orchestrating microservices or conventional API traffic - and agentic LLM and MCP as well - with ease.

Kong runs natively on Kubernetes thanks to its official Kubernetes Ingress Controller.



Installation | Documentation | Discussions | Forum | Blog | Builds | AI Gateway | Cloud Hosted Kong


Getting Started

If you prefer to use a cloud-hosted Kong, you can sign up for a free trial of Kong Konnect and get started in minutes. If not, you can follow the instructions below to get started with Kong on your own infrastructure.

Let’s test drive Kong by adding authentication to an API in under 5 minutes.

We suggest using the docker-compose distribution via the instructions below, but there is also a docker installation procedure if you’d prefer to run the Kong Gateway in DB-less mode.

Whether you’re running in the cloud, on bare metal, or using containers, you can find every supported distribution on our official installation page.

  1. To start, clone the Docker repository and navigate to the compose folder.
  $ git clone https://github.com/Kong/docker-kong
  $ cd docker-kong/compose/
  1. Start the Gateway stack using:
  $ KONG_DATABASE=postgres docker-compose --profile database up

The Gateway is now available on the following ports on localhost:

Next, follow the quick start guide to tour the Gateway features.

Getting started with AI Gateway for LLM and MCP

If you would like to get started with Kong AI Gateway capabilities including LLM and MCP features, please refer to the official AI documentation.

Features

By centralizing common API, AI and MCP functionality across all your organization's services, Kong Gateway creates more freedom for engineering teams to focus on the challenges that matter most.

The top Kong features include:

Plugin Hub

Plugins provide advanced functionality that extends the use of the Gateway. Many of the Kong Inc. and community-developed plugins like AWS Lambda, Correlation ID, and Response Transformer are showcased at the Plugin Hub.

Contribute to the Plugin Hub and ensure your next innovative idea is published and available to the broader community!

Contributing

We ❤️ pull requests, and we’re continually working hard to make it as easy as possible for developers to contribute. Before beginning development with the Kong Gateway, please familiarize yourself with the following developer resources:

Use the Plugin Development Guide for building new and creative plugins, or browse the online version of Kong's source code documentation in the Plugin Development Kit (PDK) Reference. Developers can build plugins in Lua, Go or JavaScript.

Releases

Please see the Changelog for more details about a given release. The SemVer Specification is followed when versioning Gateway releases.

Join the Community

Konnect Cloud

Kong Inc. offers commercial subscriptions that enhance the Kong Gateway in a variety of ways. Customers of Kong's Konnect Cloud subscription take advantage of additional gateway functionality, commercial support, and access to Kong's managed (SaaS) control plane platform. The Konnect Cloud platform features include real-time analytics, a service catalog, developer portals, and so much more! Get started with Konnect Cloud.

License

Copyright 2016-2026 Kong Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

kong (Kong/kong)

Searching Database…

44.3K ·GitHub
What is this?Kong is a cloud-native API gateway that also acts as an AI and MCP gateway, handling routing, load balancing, authentication, and traffic management for microservices and LLM/agentic traffic.
Is this a library I import, or a standalone service I run?It's a standalone proxy server you deploy (e.g. via Docker) in front of your APIs, not a library you import into code.
How do I get it running?Clone the Docker repository, go to the compose folder, and start the stack; the gateway then listens on localhost:8000 (proxy), 8001 (Admin API) and 8002 (Kong Manager Web UI).
Do I need Docker to try it, or can I run it bare metal?Docker Compose is the recommended quick-start path, but Kong also supports bare metal, container, and Kubernetes deployments via its official install page.
Can I run it without a database?Yes, Kong supports a DB-less declarative configuration mode in addition to the traditional database-backed setup.
Does it run on Kubernetes?Yes, Kong has a native Kubernetes Ingress Controller for running directly on Kubernetes clusters.
What LLM providers does the AI Gateway support?It offers a universal LLM API that routes across multiple providers including OpenAI, Anthropic, GCP Gemini, AWS Bedrock, Azure AI, Databricks, Mistral and Huggingface.
What can Kong do with MCP traffic?Kong provides MCP traffic governance, security, and observability, and can even auto-generate MCP servers from any RESTful API.
Can I extend Kong with custom plugins?Yes, Kong has a plugin system and Plugin Hub; developers can build plugins in Lua, Go or JavaScript using the Plugin Development Kit.
Is there a managed/cloud version if I don't want to self-host?Yes, Kong Konnect is a commercial cloud-hosted SaaS control plane offering additional features, analytics, and support on top of the open-source Gateway.
What are similar projects?tyk, apisix, busbar, litellm, bifrost, evenfire, istio, OmniRoute
Creator
Kong
Size
95.7 MB
Stars
44.3K
Age
11y
Commits · 90 Days