Kong Konnect MCP サーバー

静的バッジ

Kong Konnect API と対話するためのモデルコンテキストプロトコル (MCP) サーバー。AI アシスタントが Kong Gateway の構成、トラフィック、分析を照会および分析できるようにします。

https://github.com/user-attachments/assets/19c2f716-49b5-46c3-9457-65b3784e2111

概要

このプロジェクトは、ClaudeのようなAIアシスタントがKong KonnectのAPIゲートウェイと連携できるようにするModel Context Protocol（MCP）サーバーを提供します。分析データのクエリ、構成の詳細の検査、自然言語による会話によるコントロールプレーンの管理など、一連のツールを提供します。

主な機能:

カスタマイズ可能なフィルターを使用したクエリ API リクエスト分析
ゲートウェイサービス、ルート、コンシューマー、プラグインを一覧表示して検査する
コントロールプレーンとコントロールプレーングループを管理する
Claude やその他の MCP 対応 AI アシスタントとの統合

Konnect MCP は現在開発中であり、リリースごとに機能と改善が追加される予定です。

プロジェクト構造

src/
├── index.ts              # Main entry point
├── api.ts                # Kong API client
├── tools.ts              # Tool definitions
├── parameters.ts         # Zod schemas for tool parameters
├── prompts.ts            # Detailed tool documentation
├── operations/
│   ├── analytics.ts      # API request analytics operations
│   ├── configuration.ts  # Services, routes, consumers, plugins
│   └── controlPlanes.ts  # Control plane management
└── types.ts              # Common type definitions

インストール

前提条件

Node.js 20以上
APIアクセス可能なKong Konnectアカウント
MCP 機能を備えたクライアント (例: Claude Desktop、Cursor など)

設定

# Clone the repository
git clone https://github.com/Kong/mcp-konnect.git
cd mcp-konnect

# Install dependencies
npm install

# Build the project
npm run build

構成

MCP サーバーを構成するには、次の環境変数を設定します。

# Required: Your Kong Konnect API key
export KONNECT_ACCESS_TOKEN=kpat_api_key_here

# Optional: The API region to use (defaults to US)
# Possible values: US, EU, AU, ME, IN
export KONNECT_REGION=us

利用可能なツール

サーバーは、次の 3 つのカテゴリに分類されたツールを提供します。

分析ツール

クエリAPIリクエスト

カスタマイズ可能なフィルターを使用して、Kong API Gateway リクエストをクエリおよび分析します。

Inputs:
- timeRange: Time range for data retrieval (15M, 1H, 6H, 12H, 24H, 7D)
- statusCodes: Filter by specific HTTP status codes
- excludeStatusCodes: Exclude specific HTTP status codes
- httpMethods: Filter by HTTP methods
- consumerIds: Filter by consumer IDs
- serviceIds: Filter by service IDs
- routeIds: Filter by route IDs
- maxResults: Maximum number of results to return

消費者のリクエストを取得する

特定のコンシューマーによって行われた API リクエストを分析します。

Inputs:
- consumerId: ID of the consumer to analyze
- timeRange: Time range for data retrieval
- successOnly: Show only successful (2xx) requests
- failureOnly: Show only failed (non-2xx) requests
- maxResults: Maximum number of results to return

設定ツール

リストサービス

コントロールプレーンに関連付けられているすべてのサービスを一覧表示します。

Inputs:
- controlPlaneId: ID of the control plane
- size: Number of services to return
- offset: Pagination offset token

ルート一覧

コントロールプレーンに関連付けられているすべてのルートを一覧表示します。

Inputs:
- controlPlaneId: ID of the control plane
- size: Number of routes to return
- offset: Pagination offset token

消費者リスト

コントロールプレーンに関連付けられているすべてのコンシューマーを一覧表示します。

Inputs:
- controlPlaneId: ID of the control plane
- size: Number of consumers to return
- offset: Pagination offset token

プラグイン一覧

コントロールプレーンに関連付けられているすべてのプラグインを一覧表示します。

Inputs:
- controlPlaneId: ID of the control plane
- size: Number of plugins to return
- offset: Pagination offset token

コントロールプレーンツール

コントロールプレーンの一覧

組織内のすべてのコントロールプレーンを一覧表示します。

Inputs:
- pageSize: Number of control planes per page
- pageNumber: Page number to retrieve
- filterName: Filter control planes by name
- filterClusterType: Filter by cluster type
- filterCloudGateway: Filter by cloud gateway capability
- labels: Filter by labels
- sort: Sort field and direction

コントロールプレーンを取得する

特定のコントロールプレーンに関する詳細情報を取得します。

Inputs:
- controlPlaneId: ID of the control plane to retrieve

コントロールプレーングループメンバーシップの一覧表示

特定のグループのメンバーであるすべてのコントロールプレーンを一覧表示します。

Inputs:
- groupId: Control plane group ID
- pageSize: Number of members to return per page
- pageAfter: Cursor for pagination

コントロールプレーンのグループメンバーシップを確認する

コントロールプレーンがいずれかのグループのメンバーであるかどうかを確認します。

Inputs:
- controlPlaneId: Control plane ID to check

クロードとの使用

この MCP サーバーを Claude for Desktop で使用するには:

デスクトップ版Claudeをインストールする
Claude Desktop 構成ファイルを作成または編集します。
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
次の構成を追加します。

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

デスクトップ版のClaudeを再起動
Kong Konnectツールがクロードでも使用できるようになります

ワークフローの例

APIトラフィックの分析

まず、すべてのコントロールプレーンを一覧表示します。
Please list all control planes in my Kong Konnect organization.
次に、特定のコントロールプレーンのサービスを一覧表示します。
List all services for control plane [CONTROL_PLANE_NAME/ID].
特定のサービスに対する API リクエストをクエリします。
Show me all API requests for service [SERVICE_NAME/ID] in the last hour that had 5xx status codes.

消費者問題のトラブルシューティング

コントロールプレーンのコンシューマーを一覧表示します。
List all consumers for control plane [CONTROL_PLANE_NAME/ID].
特定の消費者のリクエストを分析します。
Show me all requests made by consumer [CONSUMER_NAME/ID] in the last 24 hours.
一般的なエラーやパターンを確認します。
What are the most common errors experienced by this consumer?

発達

新しいツールの追加

パラメータをparameters.tsで定義する
prompts.tsにドキュメントを追加する
operations/内の適切なファイルに操作ロジックを作成します。
tools.tsにツールを登録する
index.tsでツールの実行を処理する

トラブルシューティング

よくある問題

接続エラー

APIキーが有効であり、必要な権限があることを確認してください
APIリージョンが正しく指定されているか確認する
ネットワークがKong Konnect APIに接続できることを確認する

認証エラー

Kong Konnect ポータルで API キーを再生成します
環境変数が正しく設定されているか確認する

データが見つかりません

リクエストで使用されているIDが正しいことを確認する
指定されたコントロールプレーンにリソースが存在することを確認します
分析クエリの時間範囲が有効であることを確認する

クレジット

Kong によって構築されました。Stripe のAgent Toolkitからインスピレーションを受けています。

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

AI アシスタントが Kong Konnect の API ゲートウェイと対話できるようにし、分析データのクエリ、構成の検査、自然言語によるコントロールプレーンの管理を行うツールを提供するモデルコンテキストプロトコルサーバー。

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Personal Assistant Agent
zhangzhongnan928
-
security
F
license
-
quality
A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
Last updated -
13
Python
Kubectl MCP Tool
rohitg00
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants to interact with Kubernetes clusters through natural language, supporting core Kubernetes operations, monitoring, security, and diagnostics.
Last updated -
660
Python
MIT License
MCP Toolkit
zxfgds
-
security
F
license
-
quality
A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
Last updated -
16
1
TypeScript
RL-MCP
rlefko
-
security
F
license
-
quality
A Model Context Protocol server that provides AI models with structured access to external data and services, acting as a bridge between AI assistants and applications, databases, and APIs in a standardized, secure way.
Last updated -
1
Python

View all related MCP servers