关键词

Kong KonnectAPI网关监控分析配置管理控制平面

项目简介

Konnect MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在使 AI 助手（如 Claude）能够与 Kong Konnect API 网关进行交互。它提供了一系列工具，可以通过自然语言对话查询分析数据、检查配置详情以及管理控制平面。

主要功能点

  • API 请求分析: 查询和分析 Kong API 网关的请求数据，支持自定义过滤器，例如时间范围、HTTP 状态码、HTTP 方法等。
  • 配置信息查询: 列出和检查 Kong 网关的服务、路由、消费者和插件等配置信息。
  • 控制平面管理: 管理 Kong Konnect 的控制平面和控制平面组。
  • 与 MCP 客户端集成: 可以与任何兼容 MCP 协议的 AI 助手客户端集成，例如 Claude Desktop。

安装步骤

  1. 克隆仓库

    git clone https://github.com/Kong/mcp-konnect.git
cd mcp-konnect

  2. 安装依赖

    npm install

  3. 构建项目

    npm run build

服务器配置

要将 Konnect MCP Server 配置为 MCP 客户端 (如 Claude) 的后端服务，您需要在客户端的配置文件中添加以下 JSON 配置。请根据您的实际环境修改配置中的路径和 API 密钥。

{
  "mcpServers": {
    "kong-konnect": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-konnect/build/index.js"  // 将 "/absolute/path/to/mcp-konnect" 替换为 mcp-konnect 项目的绝对路径
      ],
      "env": {
        "KONNECT_ACCESS_TOKEN": "kpat_api_key_here",  // 替换为您的 Kong Konnect API 密钥
        "KONNECT_REGION": "us"                           // 可选，API 区域，默认为 us，可选值：US, EU, AU, ME, IN
      }
    }
  }
}

配置参数说明:

  • 'server name': 'kong-konnect' (服务器名称，客户端内唯一标识)
  • 'command': 'node' (启动服务器的命令，这里使用 Node.js 运行时)
  • 'args': '["/absolute/path/to/mcp-konnect/build/index.js"]' (启动命令的参数，指向编译后的 'index.js' 文件)
  • 'env': 环境变量配置
    • 'KONNECT_ACCESS_TOKEN': 您的 Kong Konnect API 访问令牌，必需配置。
    • 'KONNECT_REGION': Kong Konnect API 区域，可选配置，默认为 'us'。

基本使用方法

  1. 确保已完成安装和配置步骤。
  2. 启动 MCP 客户端（如 Claude Desktop），客户端将自动连接到 Konnect MCP Server。
  3. 在 AI 助手中，您可以使用自然语言指令来调用 Konnect MCP Server 提供的工具，例如：
    • "列出我的所有 Kong Konnect 控制平面"
    • "展示控制平面 [controlPlaneId] 的所有服务"
    • "查询过去一小时内服务 [serviceId] 的 5xx 错误请求"

请参考仓库的 README.md 文件和示例工作流，了解更多工具和使用方法。

信息

分类

开发者工具

访问项目