MCP 게이트웨이

MCP 게이트웨이

MCP Gateway는 Model Context Protocol(MCP) 서버를 오케스트레이션하기 위한 Docker의 오픈소스 솔루션이에요. 클라이언트와 서버 사이의 중앙 프록시 역할을 하며 설정, 자격 증명, 접근 제어를 관리해요.

출처: 문서

본문

참고: Docker AI 거버넌스의 일부인 MCP Gateway는 초청 전용(invite-only) 기능이에요. 자세한 내용은 Docker Sales에 문의하세요.

MCP Gateway 없이 MCP 서버를 사용하면 각 AI 애플리케이션마다 개별적으로 설정해야 해요. MCP Gateway를 사용하면 애플리케이션을 Gateway에 연결하도록 설정하면 돼요. 그러면 Gateway가 프로필의 모든 서버에 대해 서버 수명 주기, 라우팅, 인증을 처리해 줘요.

MCP Toolkit이 활성화된 Docker Desktop을 사용한다면 Gateway가 백그라운드에서 자동으로 실행돼요. 수동으로 시작하거나 설정할 필요가 없죠. 이 문서는 Gateway의 동작 방식을 이해하거나 고급 사용 사례를 위해 직접 실행하고 싶은 사용자를 위한 거예요.

팁: 이제 E2B 샌드박스에는 Docker MCP 카탈로그에 대한 직접 접근이 포함되어, 개발자가 200개 이상의 도구와 서비스에 접근해 AI 에이전트를 원활하게 빌드하고 실행할 수 있어요. 자세한 내용은 E2B 샌드박스 문서를 참고해 주세요.

동작 방식

MCP Gateway는 제한된 권한, 네트워크 접근, 리소스 사용으로 MCP 서버를 격리된 Docker 컨테이너에서 실행해요. AI 도구 활동에 대한 완전한 가시성과 거버넌스를 보장하기 위해 내장된 로깅과 호출 추적(call-tracing) 기능을 포함해요.

MCP Gateway는 서버의 전체 수명 주기를 관리해요. AI 애플리케이션이 도구를 사용해야 할 때 Gateway에 요청을 보내요. Gateway는 그 도구를 처리하는 서버가 무엇인지 식별하고, 서버가 아직 실행 중이 아니면 Docker 컨테이너로 시작해요. 그런 다음 Gateway가 필요한 자격 증명을 주입하고, 보안 제한을 적용하고, 요청을 서버로 전달해요. 서버가 요청을 처리하고 결과를 Gateway를 통해 AI 애플리케이션으로 돌려보내요.

MCP Gateway는 근본적인 문제를 해결해 줘요. MCP 서버는 어딘가에서 실행되어야 하는 프로그램일 뿐이기 때문이에요. 그걸 자기 머신에서 직접 실행하면 설치, 의존성, 업데이트, 보안 위험을 다뤄야 해요. Gateway가 관리하는 컨테이너로 실행하면 격리, 일관된 환경, 중앙 집중식 제어를 얻을 수 있어요.

Gateway는 프로필과 함께 동작해 어떤 서버를 사용할 수 있는지 정해요. Gateway를 실행할 때 --profile 플래그로 사용할 프로필을 지정해 어떤 서버를 클라이언트에 공개할지 정해요.

사용법

MCP Gateway를 사용하려면 MCP Toolkit이 활성화된 Docker Desktop이 필요해요. MCP Toolkit 가이드에 따라 Docker Desktop 인터페이스로 서버를 활성화하고 구성하거나, 터미널 기반 워크플로를 보려면 CLI로 MCP Toolkit 사용하기 문서를 참고해 주세요.

MCP Gateway를 수동으로 설치하기

Docker Desktop 없는 Docker Engine을 사용한다면 실행 전에 MCP Gateway를 별도로 다운로드해 설치해야 해요.

1. GitHub 릴리스 페이지에서 최신 바이너리를 다운로드합니다.
2. OS에 맞는 대상 위치로 바이너리를 이동하거나 심볼릭 링크를 만듭니다.

3. 바이너리를 실행 가능하게 만듭니다:

$ chmod +x ~/.docker/cli-plugins/docker-mcp

이제 docker mcp 명령을 사용할 수 있어요:

docker mcp --help

추가 정보

MCP Gateway의 동작 방식과 사용 가능한 커스터마이즈 옵션에 대한 자세한 내용은 GitHub의 전체 문서를 참고해 주세요.

더 알아보기 (Learn more)