Kong Konnect MCP 서버

Kong Konnect API와 상호 작용하기 위한 MCP(Model Context Protocol) 서버로, AI 어시스턴트가 Kong Gateway 구성, 트래픽 및 분석을 쿼리하고 분석할 수 있습니다.

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

개요

이 프로젝트는 Claude와 같은 AI 비서가 Kong Konnect의 API 게이트웨이와 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버를 제공합니다. 분석 데이터를 쿼리하고, 구성 세부 정보를 검사하고, 자연어 대화를 통해 제어 영역을 관리할 수 있는 도구 세트를 제공합니다.

주요 특징:

사용자 정의 가능한 필터를 사용한 쿼리 API 요청 분석
게이트웨이 서비스, 경로, 소비자 및 플러그인을 나열하고 검사합니다.
제어 평면 및 제어 평면 그룹 관리
Claude 및 기타 MCP 호환 AI 어시스턴트와의 통합

Konnect MCP는 현재 진행 중인 작업 이며, 각 릴리스마다 새로운 기능과 개선 사항을 추가할 예정입니다.

프로젝트 구조

지엑스피1

설치

필수 조건

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

사용 가능한 도구

서버는 세 가지 범주로 구성된 도구를 제공합니다.

분석 도구

쿼리 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

Claude와 함께 사용

Claude for Desktop과 함께 이 MCP 서버를 사용하려면:

데스크톱용 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를 다시 시작하세요
이제 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 에서 영감을 받았습니다.

Kong Konnect MCP Server

Integrations