agentgateway

MCP·A2A 를 아는 에이전트 전용 프록시

curl -L https://github.com/agentgateway/agentgateway/releases/latest/download/agctl-linux-amd64 -o agctl && chmod +x agctl

MCP 와 A2A 를 네이티브로 이해하는 오픈소스 프록시로, 에이전트와 모델·도구·다른 에이전트 사이의 트래픽을 한 곳에서 다룹니다. LLM 게이트웨이로 예산과 지출 한도를 걸고, MCP 게이트웨이로 도구를 연합하며, 쿠버네티스 추론 게이트웨이 확장으로 GPU 사용률과 KV 캐시를 보고 라우팅합니다.

판단

이럴 때 씁니다

  • 에이전트가 쓰는 MCP 도구들을 한 곳에서 연합하고 인증을 걸고 싶을 때
  • 모델 호출에 예산과 지출 한도를 걸어야 할 때
  • 에이전트 사이 통신까지 A2A 로 다뤄야 할 때
  • 자체 호스팅 모델로 보내는 요청을 GPU 사용률과 KV 캐시를 보고 배분하고 싶을 때

이럴 땐 쓰지 마세요

  • MCP 서버가 한두 개뿐이라 클라이언트 설정으로 충분할 때
  • 일반 웹 API 게이트웨이가 필요한 것일 때
  • 패키지 매니저 설치를 원할 때는 아직 바이너리를 직접 받아야 합니다

차별점

  • MCP 와 A2A 를 네이티브로 이해하는 프록시입니다.
  • LLM·MCP·A2A 게이트웨이를 한 프로세스에서 제공합니다.
  • GPU 사용률·KV 캐시·LoRA 어댑터·큐 깊이를 보고 추론 라우팅을 합니다.
  • API 키 단위 예산과 지출 한도를 걸 수 있습니다.

워크플로

  1. 01릴리스에서 플랫폼에 맞는 agctl 바이너리를 받아 실행 권한을 줍니다.
  2. 02단독 실행 퀵스타트로 로컬에서 먼저 붙여 봅니다.
  3. 03LLM 게이트웨이에 모델 제공자를 등록하고 예산을 겁니다.
  4. 04MCP 게이트웨이에 도구 서버들을 연합해 한 엔드포인트로 노출합니다.
  5. 05운영에서는 내장 컨트롤러와 Gateway API 로 쿠버네티스에 배포합니다.

주요 명령

명령설명
curl -L https://github.com/agentgateway/agentgateway/releases/latest/download/agctl-linux-amd64 -o agctl && chmod +x agctl리눅스용 CLI 바이너리를 받습니다.

함정

설치 전에 확인하세요

  • Homebrew 포뮬러나 설치 스크립트가 없습니다. 릴리스 바이너리를 직접 받아야 합니다.
  • README 에 설치 절차가 없고 퀵스타트 문서로 넘깁니다.
  • MCP 와 A2A 를 함께 다루는 만큼 설정 표면이 넓습니다.
  • 쿠버네티스 배포는 Gateway API 를 전제로 합니다.

비교

Higress 가 범용 API 게이트웨이에 AI 를 얹은 방향이라면, 이쪽은 처음부터 에이전트 프로토콜을 전제로 만들어졌습니다. 도구가 여러 MCP 서버에 흩어져 있고 이를 연합해 인증과 관측을 걸어야 하면 이쪽의 설계가 더 맞습니다.

최근 변경

2026-08-27 v1.5.0 에서 API 키 단위 LLM 예산, 제미나이 인바운드 API 네이티브 지원, Anthropic Messages 를 OpenAI Responses 로 변환하는 기능이 들어갔습니다. SPIFFE 워크로드 API 신원과 동적 포워드 프록시 지원도 함께 확장됐습니다.

공식 변경 내역