MCP Konnect

🚀 Kong 侃侃

Kong Konnect 是一個強大的 API 管理平臺，能助力企業管理與監控 API 服務。本文檔將詳細闡述如何藉助 Kong Konnect 的 MCP（模型上下文協議）服務器來拓展其功能。

🚀 快速開始

安裝

安裝 Kong Konnect CLI

1. 使用 npm 安裝 Kong Konnect CLI：

   npm install -g kong-konnect-cli
   

2. 驗證安裝：

   kong-konnect --version
   

啟動 MCP 服務器

安裝完成後，啟動 MCP 服務器：

node build/index.js

配置

在項目的根目錄下創建一個 config.json 文件：

{
  "api_key": "your_kong_api_key",
  "region": "us"
}

✨ 主要特性

Kong Konnect 具備強大的 API 管理與監控能力，通過 MCP 服務器可進一步擴展功能。同時提供多種實用工具，涵蓋分析、配置、控制平面等方面，方便用戶對 API 資源進行管理。

📦 安裝指南

安裝 Kong Konnect CLI

1. 使用 npm 安裝 Kong Konnect CLI：

   npm install -g kong-konnect-cli
   

2. 驗證安裝：

   kong-konnect --version
   

啟動 MCP 服務器

安裝完成後，啟動 MCP 服務器：

node build/index.js

💻 使用示例

基礎用法

示例 1: 分析 API 流量

# 列出所有控制平面
kong-konnect list-control-planes

# 獲取特定控制平面上的服務列表
kong-konnect get-services --plane-id <PLANE_ID>

# 監控特定服務的流量
kong-konnect monitor-service-traffic --service-id <SERVICE_ID>

示例 2: 配置管理

# 更新現有服務配置
kong-konnect update-service-config --service-id <SERVICE_ID> --config '{"timeout": 3000}'

# 刪除不再需要的服務
kong-konnect delete-service --service-id <SERVICE_ID>

高級用法

在實際使用中，可根據不同的業務需求，靈活組合使用各種工具，實現更復雜的 API 管理任務。例如，結合分析工具和配置工具，先分析 API 流量，再根據分析結果對服務進行配置調整。

📚 詳細文檔

項目結構

以下是 Kong Konnect 項目的文件結構：

kong-konnect/
├── parameters.ts        # 定義工具的參數
├── prompts.ts           # 工具的文檔說明
├── operations/          # 各個操作的具體實現
│   ├── list-control-planes.ts    # 列出所有控制平面
│   └── get-service-details.ts     # 獲取服務詳細信息
├── tools.ts             # 註冊並管理工具
└── index.ts             # 項目的主入口文件

可用工具

分析工具

1. 列出所有控制平面：

   kong-konnect list-control-planes
   

2. 獲取服務詳細信息：

   kong-konnect get-service-details --service-id <SERVICE_ID>
   

配置工具

1. 列出所有服務：

   kong-konnect list-services
   

2. 創建新服務：

   kong-konnect create-service --name "New Service" --endpoint "/api/new"
   

控制平面工具

1. 檢查控制平面狀態：

   kong-konnect check-control-plane-status --plane-id <PLANE_ID>
   

開發

添加新工具

1. 在 parameters.ts 中定義參數。
2. 更新 prompts.ts 中的文檔說明。
3. 實現具體的操作邏輯在 operations/ 文件夾下。
4. 註冊新的工具到 tools.ts 中。
5. 最後，在 index.ts 中處理工具的執行。

故障排除

常見問題

• 連接錯誤：檢查 API 密鑰是否有效，網絡配置是否正確。
• 權限問題：確保用戶有正確的權限訪問所需的資源。
• 數據丟失：驗證輸入的參數和 ID 是否正確無誤。

通過以上步驟，您可以順利使用 Kong Konnect 的 MCP 服務器來管理您的 API 資源。如需更多幫助，請參考官方文檔或聯繫支持團隊。