Apps Script를 활용한 JSON-RPC 기반 MCP 서버 구축 및 활용 가이드

핵심 기술

Google Apps Script와 doPost(), ContentService를 활용하여 JSON-RPC 프로토콜을 따르는 MCP(Model Context Protocol) 서버를 구축하는 방법을 소개합니다. 이를 통해 Google Workspace 환경에서 클라이언트 요청을 처리하는 자체 스크립트 서버를 구현할 수 있습니다.

기술적 세부사항

• MCP 서버 아키텍처: Google Apps Script 웹 앱을 기반으로 JSON-RPC 통신을 처리하는 서버 구조.
• doPost() 함수: POST HTTP 요청의 엔드포인트 역할을 수행하며, 인증 및 RPC 요청 처리를 위한 진입점.
• 인증 메커니즘: URL 쿼리 파라미터에 포함된 'token'을 사용하여 요청을 인증하고, 미설정 또는 잘못된 토큰에 대한 오류 응답을 제공.
• JSON-RPC 2.0 준수: 클라이언트와 서버 간의 통신을 위해 JSON-RPC 2.0 사양을 따름.
• RPC 메소드 처리: processSingleRequest_ 함수를 통해 initialize, tools/list, tools/call 등의 RPC 메소드를 라우팅하고 실행.
• 도구(Tools) 지원: AVAILABLE_TOOLS 배열에 정의된 read_recent_email과 같은 도구를 등록하고 호출하는 방식 설명.
• Helper 함수: createSuccessResponse_, createErrorResponse_를 사용하여 표준 JSON-RPC 응답 객체 생성.
• 에러 핸들링: 다양한 JSON-RPC 에러 코드(-32700 ~ -32003)와 구현 정의 에러 처리를 위한 RPC_ERRORS 맵 사용.
• Apps Script Manifest 및 배포: 웹 앱 실행 권한(USER_DEPLOYING) 및 접근 권한(ANYONE_ANONYMOUS) 설정 가이드.

개발 임팩트

• 별도의 서버 인프라 없이 Google Apps Script만으로 간단한 API 서버를 구축할 수 있어 개발 및 운영 부담 감소.
• Gmail 접근 권한을 가진 read_recent_email과 같은 기능을 외부 시스템에서 호출하여 업무 자동화 및 효율성 증대.
• 복잡한 로직이나 데이터 처리가 필요한 경우, Google Apps Script의 방대한 서비스(Drive, Calendar 등)와 연동하여 확장성 확보.

커뮤니티 반응

콘텐츠는 GitHub 저장소 및 Medium 아티클 링크를 제공하며, Google Apps Script를 활용한 확장 가능한 서버 개발에 대한 커뮤니티의 관심과 활용 가능성을 시사합니다.