mcp/kong

Kong Konnect MCP Server

镜像概述和主要用途

Kong Konnect MCP Server 是一个基于模型上下文协议（Model Context Protocol, MCP）的服务器，用于与 Kong Konnect APIs 交互。它允许 AI 助手查询和分析 Kong Gateway 的配置信息、流量数据及分析结果，提供对控制平面、消费者、服务、路由、插件等资源的管理和监控能力。

核心功能和特性

基本信息

核心工具（10个）

使用场景和适用范围

适用场景

• Kong Gateway 控制平面管理与监控
• API 流量分析与消费者行为追踪
• 服务、路由及插件配置审计
• API 请求故障排查与性能分析
• 控制平面组关系管理

目标用户

• DevOps 工程师
• API 管理员
• 系统监控与运维人员
• SRE（站点可靠性工程师）

详细使用方法和配置说明

环境变量说明

Docker 部署示例

1. 使用 docker run 命令部署

bash
docker run -i --rm \
  -e KONNECT_REGION=us \
  -e KONNECT_ACCESS_TOKEN="your_kong_connect_api_token" \
  mcp/kong

2. 使用 docker-compose 部署

创建 docker-compose.yml 文件：

yaml
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

启动服务：

bash
docker-compose up -d

镜像签名验证

为确保镜像完整性，可使用 Cosign 验证签名：

bash
COSIGN_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: 待检查的控制平面 ID

输出

• controlPlaneId: 被检查的控制平面 ID
• groupMembership: 成员关系信息，包含：
  • isMember: 布尔值，指示控制平面是否为任何组的成员
  • groupId: 所属组的 ID（若有）
  • groupName: 所属组的名称
  • status: 成员关系状态（如 OK、CONFLICT）
  • message: 状态描述信息
  • conflicts: 配置冲突列表（若有）
• relatedTools: 相关管理工具列表

工具：get_consumer_requests

功能：检索并分析特定消费者发起的 API 请求。

参数说明

输入

• 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: 控制平面 ID

输出

• controlPlaneDetails: 控制平面详细信息，包含：
  • controlPlaneId: 控制平面唯一标识
  • name: 显示名称
  • description: 描述信息
  • type: 类型
  • clusterType: 底层集群类型
  • controlPlaneEndpoint: 控制平面端点 URL
  • telemetryEndpoint: 遥测端点 URL
  • hasCloudGateway: 是否启用云网关
  • labels: 标签
  • metadata: 创建及更新时间戳
• relatedTools: 相关分析工具列表

工具：list_consumers

功能：列出与控制平面关联的所有消费者。

参数说明

输入

• controlPlaneId: 控制平面 ID
• size: 返回数量（可选）
• offset: 分页偏移（可选）

输出

• metadata: 元数据，包含 controlPlaneId、size、offset、nextOffset、totalCount
• consumers: 消费者列表，每个消费者包含：
  • consumerId: 唯一标识
  • username: 用户名
  • customId: 自定义 ID
  • tags: 标签
  • enabled: 是否启用
  • metadata: 创建及更新时间戳
• relatedTools: 消费者分析相关工具列表

工具：list_control_plane_group_memberships

功能：列出特定控制平面组的所有成员控制平面。

参数说明

输入

• groupId: 控制平面组 ID
• pageSize: 每页数量（可选）
• pageAfter: 分页游标（可选）

输出

• metadata: 元数据，包含 groupId、pageSize、pageAfter、nextPageAfter、totalCount
• members: 成员控制平面列表，每个成员包含：
  • controlPlaneId: 唯一标识
  • name: 显示名称
  • description: 描述信息
  • type: 类型
  • clusterType: 底层集群类型
  • membershipStatus: 成员状态（包含 status、message、conflicts）
  • metadata: 创建及更新时间戳
• relatedTools: 组管理相关工具列表

工具：list_control_planes

功能：列出组织中的所有控制平面。

参数说明

输入

• pageSize: 每页数量（可选）
• pageNumber: 页码（可选）
• filterName: 名称筛选（可选）
• filterClusterType: 集群类型筛选（可选）
• filterCloudGateway: 云网关筛选（可选）
• labels: 标签筛选（可选）
• sort: 排序方式（可选）

输出

• metadata: 元数据，包含 pageSize、pageNumber、totalPages、totalCount、filters、sort
• controlPlanes: 控制平面列表，每个控制平面包含：
  • controlPlaneId: 唯一标识
  • name: 显示名称
  • description: 描述信息
  • type: 类型
  • clusterType: 底层集群类型
  • controlPlaneEndpoint: 控制平面端点 URL
  • telemetryEndpoint: 遥测端点 URL
  • hasCloudGateway: 是否启用云网关
  • labels: 标签
  • metadata: 创建及更新时间戳
• usage: 结果使用说明

工具：list_plugins

功能：列出与控制平面关联的所有插件。

参数说明

输入

• controlPlaneId: 控制平面 ID
• size: 返回数量（可选）
• offset: 分页偏移（可选）

输出

• metadata: 元数据，包含 controlPlaneId、size、offset、nextOffset、totalCount
• plugins: 插件列表，每个插件包含：
  • pluginId: 唯一标识
  • name: 插件名称（如 rate-limiting、cors）
  • enabled: 是否启用
  • config: 插件配置
  • protocols: 适用协议
  • tags: 标签
  • scoping: 作用域（包含 consumerId、serviceId、routeId、global）
  • metadata: 创建及更新时间戳
• relatedTools: 插件配置相关工具列表

工具：list_routes

功能：列出与控制平面关联的所有路由。

参数说明

输入

• controlPlaneId: 控制平面 ID
• size: 返回数量（可选）
• offset: 分页偏移（可选）

输出

• metadata: 元数据，包含 controlPlaneId、size、offset、nextOffset、totalCount
• routes: 路由列表，每个路由包含：
  • routeId: 唯一标识
  • name: 显示名称
  • protocols: 接受的协议（如 http、https、grpc）
  • methods: 接受的 HTTP 方法
  • hosts: 匹配的主机名
  • paths: 匹配的 URL 路径
  • stripPath: 是否剥离匹配的路径前缀
  • preserveHost: 是否保留主机头
  • serviceId: 转发目标服务 ID
  • enabled: 是否启用
  • metadata: 创建及更新时间戳
• relatedTools: 相关分析工具列表

工具：list_services

功能：列出与控制平面关联的所有服务。

参数说明

输入

• controlPlaneId: 控制平面 ID
• size: 返回数量（可选）
• offset: 分页偏移（可选）

输出

• metadata: 元数据，包含 controlPlaneId、size、offset、nextOffset、totalCount
• services: 服务列表，每个服务包含：
  • serviceId: 唯一标识
  • name: 显示名称
  • host: 目标主机
  • port: 目标端口
  • protocol: 使用协议（如 http、https、grpc）
  • path: 路径前缀