Kong Konnect MCP Server

警告

⚠️ このリポジトリは非推奨です

このプロジェクトは積極的なメンテナンスを終了しており、読み取り専用でアーカイブされます。

今後、更新、バグ修正、新機能の追加は行われません。Issue とプルリクエストも監視されなくなります。

Kong Konnect MCP のサポートをお探しの場合は、Konnect remote MCP serverをご確認ください。

---

Kong Konnect MCP サーバー

注記： このリポジトリは非推奨であり、まもなく読み取り専用でアーカイブされます。詳細は上記のお知らせをご覧ください。

Kong Konnect API と連携するための Model Context Protocol（MCP）サーバーです。AI アシスタントが Kong Gateway の構成、トラフィック、分析データを照会して分析できます。

目次

• 概要
• プロジェクト構成
• インストール
• 構成
• 利用可能なツール
  • 分析ツール
  • 構成ツール
  • コントロールプレーンツール
• Claude での使用方法
• ワークフローの例
• 開発
• トラブルシューティング

概要

⚠️ 非推奨： このプロジェクトはメンテナンスされていません。以下の情報は参考用としてのみ掲載しています。

このプロジェクトは、Claude などの AI アシスタントが Kong Konnect の API Gateway と連携できるようにする Model Context Protocol（MCP）サーバーを提供します。自然言語での会話を通じて、分析データの照会、構成の詳細の確認、コントロールプレーンの管理を行うためのツールを備えています。

主な機能：

• カスタマイズ可能なフィルターを使用した API リクエスト分析の照会
• ゲートウェイのサービス、ルート、コンシューマー、プラグインの一覧表示と確認
• コントロールプレーンとコントロールプレーングループの管理
• Claude およびその他の MCP 対応 AI アシスタントとの連携

プロジェクト構成

build/                    # Committed compiled JavaScript output used by the release/distribution flow
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

# Run the test suite (also rebuilds compiled output)
npm test

# Rebuild the committed build artifacts after changing src/
npm run build

このリポジトリには、配布モデルの一部として build/ 内のコミット済みファイルが含まれています。src/ 内のファイルを変更した場合は、変更をコミットまたは公開する前に 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: Control plane ID
- size: Number of services to return
- offset: Pagination offset token

ルートの一覧表示

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

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

コンシューマーの一覧表示

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

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

プラグインの一覧表示

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

Inputs:
- controlPlaneId: Control plane ID
- size: Number of plugins to return
- offset: Pagination offset token
- includeRawConfig: Set to true to include raw plugin configuration values (defaults to false)

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

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

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

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: Control plane ID 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

Claude での使用方法

注記： この設定は、過去の情報を参照するために提供されています。セットアップに関する問題へのサポートはありません。

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

1. Claude for Desktop をインストールします

2. Claude Desktop の設定ファイルを作成または編集します：

   • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

3. 次の設定を追加します：

{
  "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"
      }
    }
  }
}

4. Claude for Desktop を再起動します
5. これで、Claude が Kong Konnect ツールを使用できるようになります

ワークフローの例

API トラフィックの分析

1. まず、すべてのコントロールプレーンを一覧表示します：

   Please list all control planes in my Kong Konnect organization.
   

2. 次に、特定のコントロールプレーンのサービスを一覧表示します：

   List all services for control plane [CONTROL_PLANE_ID].
   

3. 特定のサービスの API リクエストを照会します：

   Show me all API requests for service [SERVICE_NAME/ID] in the last hour that had 5xx status codes.
   

コンシューマーの問題のトラブルシューティング

1. コントロールプレーンのコンシューマーを一覧表示します：

   List all consumers for control plane [CONTROL_PLANE_ID].
   

2. 特定のコンシューマーのリクエストを分析します：

   Show me all requests made by consumer [CONSUMER_NAME/ID] in the last 24 hours.
   

3. よくあるエラーやパターンを確認します：

   What are the most common errors experienced by this consumer?
   

開発

⚠️ このプロジェクトでは、今後コントリビューションを受け付けません。 リポジトリは読み取り専用としてアーカイブされます。プルリクエストやイシューの確認やマージは行われません。

過去の開発に関するメモ：

• npm test は TypeScript のビルドとリポジトリのテストスイートを実行します。
• build/ はこのリポジトリにコミット済みの生成物です。src/ に変更を加えた後は、npm run build で再生成してください。

トラブルシューティング

注記： この非推奨プロジェクトのサポートは提供されません。以下の情報は参照用としてのみ保存されています。

よくある問題

接続エラー

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

認証エラー

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

データが見つからない

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

クレジット

Kong が開発しました。Stripe の Agent Toolkit に着想を得て、当初開発されました。