Kong Konnect MCP Server 是一个基于模型上下文协议(Model Context Protocol, MCP)的服务器,用于与 Kong Konnect APIs 交互。它允许 AI 助手查询和分析 Kong Gateway 的配置信息、流量数据及分析结果,提供对控制平面、消费者、服务、路由、插件等资源的管理和监控能力。
| 属性 | 详情 |
|---|---|
| Docker 镜像 | https://hub.docker.com/repository/docker/mcp/kong |
| 作者 | https://github.com/Kong |
| 代码仓库 | https://github.com/Kong/mcp-konnect |
| Dockerfile | https://github.com/Kong/mcp-konnect/blob/refs/pull/7/merge/Dockerfile |
| 镜像构建方 | Docker Inc. |
| Docker Scout 健康评分 | !Docker Scout Health Score |
| 签名验证 | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/kong --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| 许可证 | Apache 许可证 2.0 |
| 工具名称 | 简要描述 |
|---|---|
check_control_plane_group_membership | 检查控制平面是否为任何组的成员 |
get_consumer_requests | 检索并分析特定消费者发起的 API 请求 |
get_control_plane | 获取特定控制平面的详细信息 |
list_consumers | 列出与控制平面关联的所有消费者 |
list_control_plane_group_memberships | 列出特定控制平面组的所有成员控制平面 |
list_control_planes | 列出组织中的所有控制平面 |
list_plugins | 列出与控制平面关联的所有插件 |
list_routes | 列出与控制平面关联的所有路由 |
list_services | 列出与控制平面关联的所有服务 |
query_api_requests | 使用自定义过滤器查询和分析 Kong API 请求 |
| 环境变量 | 描述 | 必填 | 默认值 |
|---|---|---|---|
KONNECT_REGION | Kong Konnect 区域(如 us、eu) | 是 | 无 |
KONNECT_ACCESS_TOKEN | Kong Konnect 访问令牌,用于 API 认证(从 Kong Konnect 控制台获取) | 是 | 无 |
1. 使用 docker run 命令部署
bashdocker run -i --rm \ -e KONNECT_REGION=us \ -e KONNECT_ACCESS_TOKEN="your_kong_connect_api_token" \ mcp/kong
2. 使用 docker-compose 部署
创建 docker-compose.yml 文件:
yamlversion: '3.8' services: kong-mcp-server: image: mcp/kong environment: - KONNECT_REGION=us - KONNECT_ACCESS_TOKEN=your_kong_connect_api_token stdin_open: true # 保持交互模式 tty: true # 分配伪终端 restart: unless-stopped
启动服务:
bashdocker-compose up -d
为确保镜像完整性,可使用 Cosign 验证签名:
bashCOSIGN_REPOSITORY=mcp/signatures cosign verify mcp/kong --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
check_control_plane_group_membership功能:检查控制平面是否为任何组的成员。
参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
controlPlaneId | string | 控制平面 ID(可通过 list_control_planes 工具获取) |
输入
controlPlaneId: 待检查的控制平面 ID输出
controlPlaneId: 被检查的控制平面 IDgroupMembership: 成员关系信息,包含:
isMember: 布尔值,指示控制平面是否为任何组的成员groupId: 所属组的 ID(若有)groupName: 所属组的名称status: 成员关系状态(如 OK、CONFLICT)message: 状态描述信息conflicts: 配置冲突列表(若有)relatedTools: 相关管理工具列表get_consumer_requests功能:检索并分析特定消费者发起的 API 请求。
参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
consumerId | string | 消费者 ID(可通过 analyze-failed-requests 或 query_api_requests 工具获取) |
successOnly | boolean | 可选 仅显示成功请求(2xx 状态码) |
failureOnly | boolean | 可选 仅显示失败请求(非 2xx 状态码) |
timeRange | string | 可选 数据时间范围(如 15M=15分钟、1H=1小时、24H=24小时) |
maxResults | integer | 可选 最大返回结果数 |
输入
consumerId: 消费者 ID(格式:controlPlaneID:consumerId)timeRange: 数据时间范围(可选,默认值未指定)successOnly: 是否仅返回成功请求(可选,默认 false)failureOnly: 是否仅返回失败请求(可选,默认 false)maxResults: 最大结果数(1-1000,可选)输出
metadata: 元数据,包含 consumerId、totalRequests、timeRange 及应用的过滤器statistics: 统计信息,包含:
averageLatencyMs: 平均响应时间(毫秒)successRate: 成功率(百分比)statusCodeDistribution: 状态码分布serviceDistribution: 服务分布requests: 请求列表,包含每个请求的详细信息get_control_plane功能:获取特定控制平面的详细信息。
参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
controlPlaneId | string | 控制平面 ID(可通过 list_control_planes 工具获取) |
输入
controlPlaneId: 控制平面 ID输出
controlPlaneDetails: 控制平面详细信息,包含:
controlPlaneId: 控制平面唯一标识name: 显示名称description: 描述信息type: 类型clusterType: 底层集群类型controlPlaneEndpoint: 控制平面端点 URLtelemetryEndpoint: 遥测端点 URLhasCloudGateway: 是否启用云网关labels: 标签metadata: 创建及更新时间戳relatedTools: 相关分析工具列表list_consumers功能:列出与控制平面关联的所有消费者。
参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
controlPlaneId | string | 控制平面 ID(可通过 list_control_planes 工具获取) |
size | integer | 可选 返回消费者数量(1-1000,默认 100) |
offset | string | 可选 分页偏移令牌(从上一次响应获取) |
输入
controlPlaneId: 控制平面 IDsize: 返回数量(可选)offset: 分页偏移(可选)输出
metadata: 元数据,包含 controlPlaneId、size、offset、nextOffset、totalCountconsumers: 消费者列表,每个消费者包含:
consumerId: 唯一标识username: 用户名customId: 自定义 IDtags: 标签enabled: 是否启用metadata: 创建及更新时间戳relatedTools: 消费者分析相关工具列表list_control_plane_group_memberships功能:列出特定控制平面组的所有成员控制平面。
参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
groupId | string | 控制平面组 ID(作为组的控制平面 ID) |
pageSize | integer | 可选 每页成员数量(1-1000,默认 10) |
pageAfter | string | 可选 分页游标(用于获取下一页数据) |
输入
groupId: 控制平面组 IDpageSize: 每页数量(可选)pageAfter: 分页游标(可选)输出
metadata: 元数据,包含 groupId、pageSize、pageAfter、nextPageAfter、totalCountmembers: 成员控制平面列表,每个成员包含:
controlPlaneId: 唯一标识name: 显示名称description: 描述信息type: 类型clusterType: 底层集群类型membershipStatus: 成员状态(包含 status、message、conflicts)metadata: 创建及更新时间戳relatedTools: 组管理相关工具列表list_control_planes功能:列出组织中的所有控制平面。
参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
pageSize | integer | 可选 每页控制平面数量(1-1000,默认 10) |
pageNumber | integer | 可选 页码 |
filterName | string | 可选 按名称筛选(包含匹配) |
filterClusterType | string | 可选 按集群类型筛选(如 kubernetes、docker) |
filterCloudGateway | boolean | 可选 按是否启用云网关筛选 |
labels | string | 可选 按标签筛选(格式:key:value,existCheck) |
sort | string | 可选 排序字段及方向(如 name,created_at desc) |
输入
pageSize: 每页数量(可选)pageNumber: 页码(可选)filterName: 名称筛选(可选)filterClusterType: 集群类型筛选(可选)filterCloudGateway: 云网关筛选(可选)labels: 标签筛选(可选)sort: 排序方式(可选)输出
metadata: 元数据,包含 pageSize、pageNumber、totalPages、totalCount、filters、sortcontrolPlanes: 控制平面列表,每个控制平面包含:
controlPlaneId: 唯一标识name: 显示名称description: 描述信息type: 类型clusterType: 底层集群类型controlPlaneEndpoint: 控制平面端点 URLtelemetryEndpoint: 遥测端点 URLhasCloudGateway: 是否启用云网关labels: 标签metadata: 创建及更新时间戳usage: 结果使用说明list_plugins功能:列出与控制平面关联的所有插件。
参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
controlPlaneId | string | 控制平面 ID(可通过 list_control_planes 工具获取) |
size | integer | 可选 返回插件数量(1-1000,默认 100) |
offset | string | 可选 分页偏移令牌(从上一次响应获取) |
输入
controlPlaneId: 控制平面 IDsize: 返回数量(可选)offset: 分页偏移(可选)输出
metadata: 元数据,包含 controlPlaneId、size、offset、nextOffset、totalCountplugins: 插件列表,每个插件包含:
pluginId: 唯一标识name: 插件名称(如 rate-limiting、cors)enabled: 是否启用config: 插件配置protocols: 适用协议tags: 标签scoping: 作用域(包含 consumerId、serviceId、routeId、global)metadata: 创建及更新时间戳relatedTools: 插件配置相关工具列表list_routes功能:列出与控制平面关联的所有路由。
参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
controlPlaneId | string | 控制平面 ID(可通过 list_control_planes 工具获取) |
size | integer | 可选 返回路由数量(1-1000,默认 100) |
offset | string | 可选 分页偏移令牌(从上一次响应获取) |
输入
controlPlaneId: 控制平面 IDsize: 返回数量(可选)offset: 分页偏移(可选)输出
metadata: 元数据,包含 controlPlaneId、size、offset、nextOffset、totalCountroutes: 路由列表,每个路由包含:
routeId: 唯一标识name: 显示名称protocols: 接受的协议(如 http、https、grpc)methods: 接受的 HTTP 方法hosts: 匹配的主机名paths: 匹配的 URL 路径stripPath: 是否剥离匹配的路径前缀preserveHost: 是否保留主机头serviceId: 转发目标服务 IDenabled: 是否启用metadata: 创建及更新时间戳relatedTools: 相关分析工具列表list_services功能:列出与控制平面关联的所有服务。
参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
controlPlaneId | string | 控制平面 ID(可通过 list_control_planes 工具获取) |
size | integer | 可选 返回服务数量(1-1000,默认 100) |
offset | string | 可选 分页偏移令牌(从上一次响应获取) |
输入
controlPlaneId: 控制平面 IDsize: 返回数量(可选)offset: 分页偏移(可选)输出
metadata: 元数据,包含 controlPlaneId、size、offset、nextOffset、totalCountservices: 服务列表,每个服务包含:
serviceId: 唯一标识name: 显示名称host: 目标主机port: 目标端口protocol: 使用协议(如 http、https、grpc)path: 路径前缀以下是 mcp/kong 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务