최근 'mcpgen'이라는 새로운 오픈소스 프로젝트가 공개되어 개발자들 사이에서 주목받고 있습니다. 이 도구는 OpenAPI 명세나 Postman 컬렉션 파일을 입력받아, 이를 파이썬(Python) 기반의 모델 컨텍스트 프로토콜(MCP) 서버로 자동 변환해줍니다. 단 30초 만에 API를 언어모델(LLM)이 이해하고 활용할 수 있는 형태로 만들어주는 것이 핵심 기능입니다.
mcpgen의 가장 큰 특징은 단순한 프록시(proxy) 방식이 아니라, 실제 파이썬 소스 코드를 생성해 사용자에게 제공한다는 점입니다. 이렇게 생성된 코드는 완전히 사용자의 소유가 되므로, 개발자는 이를 자유롭게 읽고, 수정하고, 배포할 수 있습니다. 예를 들어, 인증(auth) 로직을 변경하거나, 재시도(retry) 기능을 추가하고, 오류 처리 방식을 커스터마이징하는 것이 가능합니다. 이는 기존의 API-to-MCP 도구들이 런타임 프록시 형태로 작동하여 지속적인 의존성을 요구했던 것과 대비되는 큰 장점입니다.
이 도구는 특히 앤트로픽(Anthropic)의 클로드 데스크톱(Claude Desktop)과 같은 환경에서 유용하게 활용될 수 있습니다. mcpgen은 생성된 MCP 서버를 클로드 데스크톱 설정 파일에 추가하는 방법을 명확히 안내하여, 개발자들이 자신의 API를 클로드(Claude)와 같은 대규모 언어모델(LLM)에 쉽게 연결할 수 있도록 돕습니다. 이를 통해 LLM이 외부 API를 호출하여 실세계 정보를 가져오거나 특정 작업을 수행하는 '도구 사용(tool use)' 기능을 더욱 간편하게 구현할 수 있게 됩니다.
mcpgen은 빌드(build) 도구로서, 한 번 생성하고 나면 런타임(runtime)에는 mcpgen 자체에 대한 의존성이 전혀 없다는 점도 중요합니다. 이는 개발자가 생성된 서버를 어떤 환경에든 자유롭게 배포하고 관리할 수 있음을 의미합니다. 또한, 베어러 토큰(Bearer token), API 키(API Key), 기본 인증(Basic Auth) 등 다양한 API 인증 방식을 자동으로 감지하여 환경 변수로 설정해주는 기능도 포함하고 있어, 개발 편의성을 높입니다.
이러한 접근 방식은 API와 LLM의 연동을 더욱 유연하고 강력하게 만듭니다. 개발자는 복잡한 통합 과정 없이도 자신의 API를 LLM의 도구로 활용할 수 있게 되며, 이는 LLM 기반 애플리케이션 개발의 속도를 가속화할 것입니다. 장기적으로는 더 많은 API가 LLM 생태계에 편입되고, LLM이 수행할 수 있는 작업의 범위가 확장되는 데 기여할 것으로 예상됩니다.