Kong Konnect

🚀 Kong Konnect MCP 服務器

Kong Konnect 是一個功能強大的 API 與微服務管理平臺。藉助 MCP（管理控制平面）協議，您能輕鬆與 Kong Konnect 交互並執行各類操作。本文檔將為您詳細介紹如何使用 Kong Konnect MCP 服務器。

🚀 快速開始

Kong Konnect 是用於管理 API 和微服務的強大平臺，通過 MCP 協議可與之交互。下面將指導您完成安裝、配置和使用 MCP 服務器。

✨ 主要特性

• 便捷交互：通過 MCP 協議，可輕鬆與 Kong Konnect 交互執行操作。
• 功能豐富：支持列出控制平面、獲取信息、創建組、分析流量、管理消費者等操作。
• 集成能力：可與 Claude Desktop 集成。

📦 安裝指南

安裝 MCP 服務器

要開始使用 Kong Konnect MCP 服務器，請按以下步驟安裝：

# 克隆 Kong Konnect 代碼倉庫
git clone https://github.com/kong/konnect.git
cd konnect

# 安裝依賴項並構建項目
make build

# 啟動 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 服務器支持的一些基本命令：

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

# 獲取特定控制平面信息
konnect-mcp get-control-plane <control_plane_id>

# 創建新的控制平面組
konnect-mcp create-group --name my_new_group

高級用法

分析 API 流量

您可以使用 MCP 服務器來分析特定服務的流量情況：

# 列出所有服務
konnect-mcp list-services <control_plane_id>

# 查詢特定時間段內的請求日誌
konnect-mcp get-requests --service-id <service_id> --start-time "2023-10-01T00:00:00Z" --end-time "2023-10-02T23:59:59Z"

管理消費者

您還可以通過 MCP 服務器來管理消費者的權限和策略：

# 列出所有消費者
konnect-mcp list-consumers <control_plane_id>

# 更新消費者的 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 文檔 或聯繫支持團隊。