Kong Konnect MCP Server
OfficialKong Konnect MCP サーバー
Kong Konnect API と対話するためのモデル コンテキスト プロトコル (MCP) サーバー。AI アシスタントが Kong Gateway の構成、トラフィック、分析を照会および分析できるようにします。
https://github.com/user-attachments/assets/19c2f716-49b5-46c3-9457-65b3784e2111
目次
Related MCP server: RL-MCP
概要
このプロジェクトは、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.jsonWindows:
%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からインスピレーションを受けています。
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityCmaintenanceA Model Context Protocol server that enables AI assistants to interact with Kubernetes clusters through natural language, supporting core Kubernetes operations, monitoring, security, and diagnostics.115947MIT
- FlicenseBquality-maintenanceA Model Context Protocol server that enables AI assistants to interact with Datadog's observability platform through natural language.72
- AlicenseBqualityFmaintenanceA Model Context Protocol server that enables AI assistants to query Prometheus metrics, discover available data, and analyze system performance through natural language interactions.5106MIT
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Kong/mcp-konnect'
If you have feedback or need assistance with the MCP directory API, please join our Discord server