Kong Konnect MCP 服务器

概述

Kong Konnect 是一个功能强大的平台，用于管理 API 和微服务。通过 MCP（管理控制平面）协议，您可以轻松地与 Kong Konnect 交互并执行各种操作。本文档将为您提供如何使用 Kong Konnect MCP 服务器的详细指南。

安装与配置

安装 MCP 服务器

要开始使用 Kong Konnect MCP 服务器，请按照以下步骤进行安装：

1. 克隆 Kong Konnect 代码仓库：

   git clone https://github.com/kong/konnect.git
   cd konnect
   

2. 安装依赖项并构建项目：

   make build
   

3. 启动 MCP 服务器：

   ./bin/konnect-mcp serve --config config.yaml
   

配置 MCP 服务器

在 config.yaml 文件中，您可以配置以下参数：

• API Key: 您的 Kong Konnect API 访问密钥。
• Region: 您使用的 Kong Konnect 区域（例如：us, eu）。
• Endpoints: Kong Konnect 的 API 端点 URL。

示例配置：

api_key: your_api_key_here
region: us
endpoints:
  - https://api.konghq.com/v1

使用 MCP 服务器

基本命令

以下是 MCP 服务器支持的一些基本命令：

• 列出所有控制平面：

  konnect-mcp list-control-planes
  

• 获取特定控制平面信息：

  konnect-mcp get-control-plane <control_plane_id>
  

• 创建新的控制平面组：

  konnect-mcp create-group --name my_new_group
  

高级功能

分析 API 流量

您可以使用 MCP 服务器来分析特定服务的流量情况。例如：

1. 列出所有服务：

   konnect-mcp list-services <control_plane_id>
   

2. 查询特定时间段内的请求日志：

   konnect-mcp get-requests --service-id <service_id> --start-time "2023-10-01T00:00:00Z" --end-time "2023-10-02T23:59:59Z"
   

管理消费者

您还可以通过 MCP 服务器来管理消费者的权限和策略。例如：

1. 列出所有消费者：

   konnect-mcp list-consumers <control_plane_id>
   

2. 更新消费者的 API 访问权限：

   konnect-mcp update-consumer <consumer_id> --add-permission "/my_api/*"
   

与 Claude 集成

安装 Claude Desktop

1. 下载并安装 Claude Desktop。

2. 打开配置文件：

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. 添加 Kong Konnect MCP 服务器的配置：

   {
     "mcpServers": {
       "kong-konnect": {
         "command": "node",
         "args": [
           "/absolute/path/to/mcp-konnect/build/index.js"
         ],
         "env": {
           "KONNECT_ACCESS_TOKEN": "your_api_key_here",
           "KONNECT_REGION": "us"
         }
       }
     }
   }
   

4. 重启 Claude Desktop 以应用配置。

常见问题

如何获取 API Key？

请访问 Kong Konnect 控制台，前往 Settings > API Keys 部分生成新的 API Key。

如何解决连接问题？

确保您的 Kong Konnect 实例运行正常，并且网络连接没有被阻止。您也可以检查日志文件以获取更多信息：

journalctl -u konnect-mcp.service --since "10 minutes ago"

示例代码

创建自定义插件

以下是一个简单的 Node.js 插件示例：

const { MCPClient } = require('kong-konnect');

async function main() {
  const client = new MCPClient({
    apiKey: 'your_api_key_here',
    region: 'us'
  });

  // 获取所有控制平面组
  const groups = await client.listGroups();
  console.log(groups);
}

main().catch(console.error);

结束语

通过本文档，您应该能够顺利地使用 Kong Konnect MCP 服务器并完成各种操作。如果需要更多帮助，请参考 Kong Konnect 文档 或联系支持团队。