本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

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 命令部署docker run -i --rm \ -e KONNECT_REGION=us \ -e KONNECT_ACCESS_TOKEN="your_kong_connect_api_token" \ mcp/kong
docker-compose 部署创建 docker-compose.yml 文件:
version: '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
启动服务:
docker-compose up -d
为确保镜像完整性,可使用 Cosign 验证签名:
COSIGN_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 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429