Cymbal Life Smart Branch Kiosk를 위한 엔터프라이즈급, 디커플링된 모듈형 MCP 도구, 계리 엔진 및 BigQuery APM 분석 플랫폼으로, Google Agent Development Kit (ADK), Model Context Protocol (MCP), Google AlloyDB for PostgreSQL, Google BigQuery를 기반으로 구축되었습니다.
이 서비스는 모듈형 도구 실행 마이크로서비스, AlloyDB에 대한 5ms 미만 VPC 데이터베이스 쿼리, 실시간 계리 비교(대출 vs 해지), 지점 내 VIP 대기열 티켓 발급, 그리고 포괄적인 BigQuery 애플리케이션 성능 모니터링(APM)을 제공합니다.
시스템은 네 개의 개별 운영 계층으로 구성됩니다.
클라이언트 및 지점 내 키오스크 계층:
스마트 키오스크 터치 인터페이스: 실시간 정책 조회 카드, 대출 계산기, 대기열 토큰 번호를 표시하는 고해상도 터치스크린 단말기입니다.
AudioWorklet 프로세서: 지점 마이크에서 16kHz 선형 PCM 오디오를 캡처합니다.
라이브 키오스크 텔레메트리 모니터: 실시간 함수 호출, 서버 지연 시간, 도구 인자를 표시합니다.
실시간 스트리밍 게이트웨이 및 ADK 에이전트 코어(Cloud Run):
FastAPI 비동기 WebSocket 브리지(/ws/live): 양방향 오디오/비디오 스트림을 Vertex AI Gemini Live API에 프록시합니다.
ADK 가상 지점 상담 에이전트("Priya"): 고객의 의도를 조율하고, 보험계약자 신원을 확인하며, 도메인 도구를 실행합니다.
라이브 이벤트 텔레메트리 브로드캐스터(_notify_ui): 실시간 데이터베이스 쿼리 결과와 계리 계산 카드를 키오스크 화면에 푸시합니다.
모듈형 Model Context Protocol (MCP) 도구 계층:
policy_tools 마이크로서비스: 고객 KYC, 플랜 사양, 총 납입 보험료에 대한 AlloyDB 실시간 SQL 쿼리를 실행합니다.
actuarial_tools 의사결정 엔진: 보험 해지 몰수 패널티(-₹4.2L)와 키오스크 즉시 보험 대출(₹4.8L @ 8.5%) 사이의 정확한 재무적 트레이드오프를 계산합니다.
branch_tools 운영 마이크로서비스: VIP 대기열 에스컬레이션 토큰(#RET-04)을 생성하고, 브랜치 매니저 캐빈 2에 배정하며, WhatsApp으로 디지털 전표를 발송합니다.
엔터프라이즈 데이터, APM 분석 및 옴니채널 계층:
Google AlloyDB for PostgreSQL: 5ms 미만의 VPC 쿼리를 통해 고객 KYC 기록, 유효 보험 계약, 해지 일정, 에스컬레이션 티켓을 관리하는 엔터프라이즈 데이터베이스 클러스터입니다.
Google BigQuery APM 및 에이전트 분석 스위트: 단계별 에이전트 궤적, 도구 지연 시간, 토큰 소비량, 유지 전환 퍼널을 기록합니다.
Twilio WhatsApp Business API: 디지털 VIP 토큰 전표와 캐빈 라우팅 맵을 고객의 휴대폰 번호로 발송합니다.
Related MCP server: MCP Business AI Transformation
도구 마이크로서비스는 backend/tools/ 아래에 있습니다.
도구 모듈 | 함수 이름 | 카테고리 | 설명 |
| 코어 뱅킹 | 고객 KYC, 플랜 사양, 총 납입 보험료(₹6.0L), 해지 환급금(.₹3.8L)을 포함한 실시간 AlloyDB 쿼리를 제공합니다. | |
| 계약 엔진 | 해지 손실(-₹4.2L) vs 키오스크 즉시 대출(₹4.8L @ 8.5%) vs 감액 완납(단, may) 상태 간의 재무적 트레이드오프를 비교합니다. | |
| 운영 | 지점 내 VIP 에스컬레이션 티켓( |
이 플랫폼은 docs/ANALYTICS_QUERIES.md에 문서화된 완전한 BigQuery 애플리케이션 성능 모니터링(APM) 스위트를 포함합니다.
세션 궤적 및 도구 실행 감사: 단계별 도구 호출과 실행 시간을 추적합니다.
체감 지연 시간 및 P95 분포: 음성에서 도구까지의 왕복 지연 시간(목표 <150ms)을 모니터링합니다.
유지 전환 및 보험 대출 수용률: 해지 의도가 있는 고객 중 얼마나 많은 고객이 키오스 즉시 대출 상품으로 전환하는지 측정합니다.
지점 대기열 및 VIP 티켓 에스컬레이션 APM: 지점 캐빈 전반에 걸친 에스컬레이션 티켓 해결 시간을 추적합니다.
cymbal-kiosk-tools-apm/
├── docs/
│ ├── architecture.jpg # High-level architecture block diagram
│ ├── ARCHITECTURE.md # Full enterprise architecture specification
│ └── ANALYTICS_QUERIES.md # BigQuery APM SQL queries & trajectory audit
├── pyproject.toml # Dependencies (google-adk, fastapi, psycopg2-binary, uvicorn)
├── requirements.txt # Python dependencies
├── run.sh # Local startup script
├── Dockerfile # Production container spec
├── .gitignore
├── .env.example # Environment configuration template
├── backend/
│ ├── __init__.py
│ ├── agent.py # ADK Agent definition & retention prompt
│ ├── database.py # Google AlloyDB PostgreSQL connector (psycopg2)
│ ├── mcp_tools.py # MCP tools facade & WebSocket telemetry broadcaster
│ ├── analytics.py # BigQuery agent analytics plugin
│ ├── avatar.png # Assistant avatar asset
│ ├── server.py # FastAPI WebSocket /ws/live endpoint
│ └── tools/ # Modular MCP Tool Microservices
│ ├── __init__.py
│ ├── policy_tools.py # Policy lookup microservice
│ ├── actuarial_tools.py # Actuarial decision engine
│ └── branch_tools.py # VIP escalation & WhatsApp dispatcher
└── frontend/
├── index.html # Kiosk terminal touch interface
├── style.css # Cymbal Life corporate styling
├── app.js # WebSocket client & telemetry renderer
└── dashboard.html # Executive APM Analytics Dashboard파이썬: 3.11 ~ 3.13
Google Cloud SDK (gcloud): 활성 GCP 프로젝트로 구성되어 있어야 합니다.
Google AlloyDB for PostgreSQL: 고객 및 보험 계약 스키마에 접근 가능한 클러스터가 필요합니다.
git clone https://github.com/niteshwalia0124/cymbal-kiosk-tools-apm.git
cd cymbal-kiosk-tools-apm
# Create .env from template
cp .env.example .env.env 변수를 구성하세요.
GOOGLE_GENAI_USE_VERTEXAI=true
GOOGLE_CLOUD_PROJECT=your-gcp-project-id
GOOGLE_CLOUD_LOCATION=us-central1
PORT=8080
AVATAR_NAME=Priya
# AlloyDB / Cloud SQL PostgreSQL Connection
DB_USER=postgres
DB_PASS=your-database-password
DB_NAME=postgres
DB_HOST=10.48.19.2
DB_PORT=5432
# Twilio WhatsApp (Optional)
TWILIO_ACCOUNT_SID=
TWILIO_AUTH_TOKEN=
TWILIO_WHATSAPP_FROM=whatsapp:+14155238886
# BigQuery Agent Analytics
BIGQUERY_PROJECT_ID=your-gcp-project-id
BIGQUERY_DATASET_ID=cymbal_kiosk_analytics
BIGQUERY_TABLE_ID=agent_trajectory_logsGoogle Cloud에 인증하세요.
gcloud auth application-default login
gcloud config set project your-gcp-project-idchmod +x run.sh
./run.sh브라우저에서 **주소 http://localhost:8080**를 열어 키오스크 도구와 텔레메트리 대시보드를 사용해 보세요.
AlloyDB용 VPC 피어링을 사용해 모듈형 도구 서비스를 Google Cloud Run에 배포합니다.
export PROJECT_ID=$(gcloud config get-value project)
export REGION="us-central1"
export SERVICE_NAME="cymbal-kiosk-tools-apm"
gcloud run deploy $SERVICE_NAME \
--source . \
--region $REGION \
--project $PROJECT_ID \
--allow-unauthenticated \
--set-env-vars GOOGLE_CLOUD_PROJECT=$PROJECT_ID,GOOGLE_CLOUD_LOCATION=$REGION,DB_HOST=10.48.19.2 \
--vpc-connector="projects/$PROJECT_ID/locations/$REGION/connectors/kiosk-vpc-connector" \
--memory 2Gi \
--cpu 2 \
--timeout 3600이 프로젝트는 Apache 2.0 라이선스를 따릅니다. 자세한 내용은 LICENSE 파일을 참조하세요.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
An AI concierge that turns static forms into adaptive AI conversations. From any MCP client.
34 production API tools over one hosted MCP endpoint.
Remote MCP for A2A failure replay MCP, structured receipts, audit logs, and reviewer-ready evidence.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/niteshwalia0124/cymbal-kiosk-tools-apm'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
