Gradio가 MCP 서버에 5가지 기능을 추가해 파일 업로드 자동화, 실시간 진행 상황 알림, OpenAPI 스키마 자동 변환, 인증 헤더 추출, 도구 설명 커스터마이징 지원

Context

원격 Gradio MCP 서버에 파일을 입력받아야 할 때 파일을 공개 URL로 호스팅하는 수동 단계가 필수였다. OpenAPI 스펙으로 정의된 기존 백엔드 API를 MCP 도구로 통합하려면 각 엔드포인트를 수동으로 매핑해야 하는 번거로운 작업이 있었다. MCP 서버 개발자가 클라이언트에 필요한 인증 자격증명을 명확하게 전달하고 사용자별 요청 처리 시 필요한 헤더를 자동 추출하는 방식이 부재했다.

Technical Solution

• 파일 업로드 자동화: 별도의 "File Upload" MCP 서버를 제공해 에이전트가 파일을 직접 Gradio 애플리케이션에 업로드 가능하게 함
• 실시간 진행 상황 알림: Gradio가 MCP 클라이언트로 progress 상태를 스트리밍 전송해 작업 진행 상황을 모니터링
• OpenAPI 자동 변환: gr.load_openapi() 함수로 OpenAPI 스키마에서 Gradio 애플리케이션을 직접 생성하고 mcp_server=True로 자동 MCP 서버 생성
• 인증 헤더 자동 추출: MCP 서버 함수 인자를 gr.Header 타입으로 지정하면 incoming request에서 헤더를 자동 추출해 전달
• 도구 설명 커스터마이징: api_description 파라미터로 함수명과 docstring 기반 자동 생성 설명을 사용자 정의 가능

Key Takeaway

MCP 서버 개발자가 반복적인 수동 작업(파일 호스팅, 엔드포인트 매핑, 헤더 처리)을 프레임워크 수준에서 자동화하면 LLM 에이전트 통합의 마찰을 크게 줄일 수 있다.