
Kong Konnect MCP Server 是一个基于模型上下文协议(Model Context Protocol, MCP)的服务器,用于与 Kong Konnect APIs 交互。它允许 AI 助手查询和分析 Kong Gateway 的配置信息、流量数据及分析结果,提供对控制平面、消费者、服务、路由、插件等资源的管理和监控能力。
| 属性 | 详情 |
|---|---|
| Docker 镜像 | mcp/kong |
| 作者 | Kong |
| 代码仓库 | [***] |
| Dockerfile | [***] |
| 镜像构建方 | Docker Inc. |
| Docker Scout 健康评分 | !Docker Scout Health Score |
| 签名验证 | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/kong --key [***] |
| 许可证 | 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 控制台获取) | 是 | 无 |
docker run 命令部署bashdocker run -i --rm \ -e KONNECT_REGION=us \ -e KONNECT_ACCESS_TOKEN="your_kong_connect_api_token" \ mcp/kong
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 [***]
check_control_plane_group_membership功能:检查控制平面是否为任何组的成员。
| 参数名 | 类型 | 描述 |
|---|---|---|
controlPlaneId | string | 控制平面 ID(可通过 list_control_planes 工具获取) |
controlPlaneId: 待检查的控制平面 IDcontrolPlaneId: 被检查的控制平面 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: 控制平面 IDcontrolPlaneDetails: 控制平面详细信息,包含:
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: 路径前缀
来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429