Kong Konnect MCP Server
2025.04.09
22
TypeScriptAPI 网关数据分析配置管理开发效率
Kong Konnect MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，旨在与 Kong Konnect 的 API 网关进行交互。它允许 AI 助手（如 Claude）通过自然语言查询和分析 Kong 网关的配置、流量和统计数据。该服务提供了丰富的工具集，包括查询 API 请求分析、检查配置详情以及管理控制平面等功能。
View on GitHub
Overview
基本能力
产品定位
Kong Konnect MCP Server 是一个为 AI 助手设计的中间件服务，用于与 Kong Konnect API 网关进行交互，提供数据查询和配置管理能力。
核心功能
- 查询 API 请求分析：支持自定义时间范围、状态码、HTTP 方法等过滤器。
- 检查配置详情：列出和检查网关服务、路由、消费者和插件。
- 管理控制平面：支持控制平面和控制平面组的列表、查询和管理。
- 与 AI 助手集成：兼容 Claude 等支持 MCP 的 AI 助手。
适用场景
- API 流量分析：实时监控和分析 API 请求的流量和错误。
- 配置管理：快速查询和修改网关配置。
- 故障排查：识别和解决消费者或服务的问题。
工具列表
- Analytics Tools
- Query API Requests：查询和分析 API 请求。
- Get Consumer Requests：分析特定消费者的 API 请求。
- Configuration Tools
- List Services：列出控制平面的所有服务。
- List Routes：列出控制平面的所有路由。
- List Consumers：列出控制平面的所有消费者。
- List Plugins：列出控制平面的所有插件。
- Control Planes Tools
- List Control Planes：列出组织中的所有控制平面。
- Get Control Plane：获取特定控制平面的详细信息。
- List Control Plane Group Memberships：列出特定组的所有控制平面成员。
- Check Control Plane Group Membership：检查控制平面是否属于任何组。
常见问题解答
- Connection Errors：检查 API 密钥的有效性和网络连接。
- Authentication Errors：重新生成 API 密钥并检查环境变量。
- Data Not Found：验证资源 ID 和时间范围的有效性。
使用教程
使用依赖
- Node.js 20 或更高版本
- Kong Konnect 账户：需要具有 API 访问权限。
- MCP 兼容客户端：如 Claude Desktop 或 Cursor。
安装教程
# 克隆仓库
git clone https://github.com/Kong/mcp-konnect.git
cd mcp-konnect
# 安装依赖
npm install
# 构建项目
npm run build
配置
设置以下环境变量：
export KONNECT_ACCESS_TOKEN=kpat_api_key_here
export KONNECT_REGION=us
调试方式
- 验证 API 连接：使用
List Control Planes工具检查连接是否正常。 - 检查数据查询：使用
Query API Requests工具验证数据是否正常返回。 - 查看日志：运行服务时查看控制台输出以排查错误。