Konnect MCP Server

基本能力

产品定位

Konnect MCP Server 是一个中间件服务器，专为 AI 工具与 Kong Konnect API 的交互设计。它通过实现 Model Context Protocol (MCP) 提供了一种结构化的方式来管理和操作 Konnect 资源。

核心功能

• 控制平面管理：列出和管理控制平面。
• 服务管理：列出、创建、更新和删除服务。
• 路由管理：列出、创建、更新和删除路由。
• 搜索功能：搜索 Konnect 实体并列出可搜索的类型。

适用场景

• AI 工具需要与 Kong Konnect API 进行交互时。
• 自动化管理和操作 Konnect 资源（如服务、路由）。
• 需要快速搜索和筛选 Konnect 实体时。

工具列表

Core Tools

• ListControlPlanes：列出 Konnect 账户中的控制平面。
• SearchKonnect：根据查询字符串搜索 Konnect 实体。
• ListSearchTypes：列出 Konnect 中所有可搜索的实体类型。

Service Tools

• ListServices：列出特定控制平面中的服务。
• CreateService：在控制平面中创建新服务。
• GetService：获取特定服务的详细信息。
• UpdateService：更新现有服务。
• DeleteService：删除服务。

Route Tools

• ListRoutes：列出特定控制平面中的路由。
• CreateRoute：在控制平面中创建新路由。
• GetRoute：获取特定路由的详细信息。
• UpdateRoute：更新现有路由。
• DeleteRoute：删除路由。

常见问题解答

• 如何提供 Konnect API 令牌？：可以通过命令行参数 --token=your_konnect_api_token 或环境变量 KONNECT_TOKEN 提供。
• 如何搜索特定类型的实体？：使用 SearchKonnect 工具，并指定 type:entity_type 查询条件。

使用教程

使用依赖

• Node.js (v18 或更高版本)
• Kong Konnect 账户
• 具有适当权限的 Konnect API 令牌

安装教程

1. 克隆仓库并安装依赖：

git clone https://github.com/your-username/konnect-mcp-server.git
cd konnect-mcp-server
npm install

1. 构建项目：

npm run build

调试方式

1. 启动 MCP 服务器：

npm start

或直接提供 Konnect API 令牌：

npm start -- --token=your_konnect_api_token

或设置环境变量：

export KONNECT_TOKEN=your_konnect_api_token
npm start

1. 运行测试：

npm run test

许可证

该项目遵循 MIT 开源许可条款。