Skip to main content
Glama
deenesjakoruzh
niteshwalia0124

cymbal-kiosk-tools-apm

by niteshwalia0124
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

⚙️ Cymbal Life — Smart Branch Kiosk 向けモジュール式 MCP ツール、数理エンジン、BigQuery APM 分析

Google Cloud ADK Model Context Protocol AlloyDB BigQuery APM Cloud Run License

Cymbal Life スマート支店キオスク向けのエンタープライズグレードで分離された モジュール式MCPツール、数理意思決定エンジン、BigQuery APM分析プラットフォーム です。Google Agent Development Kit (ADK)、Model Context Protocol (MCP)、Google AlloyDB for PostgreSQL、Google BigQuery 上に構築されています。

このサービスは、モジュール式のツール実行マイクロサービス、AlloyDBに対するサブ5msのVPCデータベース問い合わせ、リアルタイムの保険貸付と解約の比較、支店内VIP待機リストの発番、および包括的なBigQueryアプリケーション・パフォーマンス監視（APM）を提供します。

🏛️ 高レベルシステムアーキテクチャ

Cymbal Life Smart Branch Kiosk MCP Tools & APM Architecture

アーキテクチャ概要

システムは、次の4つの独立した運用レイヤーで構成されています。

  1. クライアントおよび支店内キオスク層:

    • Smart Kiosk タッチインターフェース: 高解像度タッチスクリーン端末に、リアルタイムの証券詳細カード、ローン計算機、待機キュー番号を表示します。

    • AudioWorklet Processor: 支店内のマイクから16kHzリニアPCM音声をキャプチャします。

    • Live Kiosk Telemetry Monitor: ライブの関数呼び出し、サーバー待機時間、ツール引数を表示します。

  2. リアルタイムストリーミングゲートウェイ & ADK エージェントコア (Cloud Run):

    • FastAPI Async WebSocket ブリッジ (/ws/live): 双方向の音声・映像ログを Vertex AI Gemini Live API に転送します。

    • ADK 仮想店舗アドバイザーエージェント ("Priya"): 顧客の意図を整理し、保険契約者の本人確認を行い、ドメインツールを実行します。

    • Live Event Telemetry Broadcaster (_notify_ui): リアルタイムのデータベース検索結果数理計算カードをキオスク画面に通知します。

  3. モデルコンテキストプロトコル（MCP）ツール層:

    • policy_tools マイクロサービス: 顧客KYC、商品仕様、総払込保険料をAlloyDBからリアルタイムSQLで検索します。

    • actuarial_tools 意思決定エンジン: 解約没収違約金（-₹4.2L）と即時キオスコアローン（₹4.8L @ 8.5%）間の根本的な財務トレードオフを計算します。

    • branch_tools 運用マイクロサービス: VIP昇格チケット（#RET-04）を発番し、支店長キャビノ2（Branch Head Mr.Vikram Mehta）に割り当て、WhatsAppでデジタル受付票を送信します。

  4. エンタープライズデータ、APM分析、オムニチャネル層:

    • Google AlloyDB for PostgreSQL: 顧客KYＣ、有効な保険証券、解約調整、昇格チケットを管理するエンタープライズデータベースのクラスタ。VPC高速通信でサブ5msの問い合わせを実現します。

    • Google BigQuery APM エージェント分析スイート: ターンごとのエージェント動線、ツールレイテンシー、トークン消費量、顧客定着のコンバージョンファネルを記録します。

    • Twilio WhatsApp Business API: デジタルVIP配送票と支店キャビの案内マップを、顧客の携帯番号に送信します。

Related MCP server: MCP Business AI Transformation

🧰 モジュール式 MCP ツールカタログ

ツールマイクロサービスは backend/tools/ にあります。

Tool Module

Function Name

Category

Description

policy_tools.py

lookup_policyholder_details

コアバンキング

顧客のKYC、プラン仕様、払込済み保険料合計（₹6.0L）、解約返戻金（₹3.8L）、契約ベネフィット（₹18L）をAlloodDBでリアルタイムに検索します。

actuarial_tools.py

calculate_surrender_penalty_vs_loan

数理エンジン

解約損（-₹4.2L）vs インストントキオ企業ローン（₹4.8L @ 8.5%）vs 減額支払いステータスなどの経済的トレードオフを比較します。

branch_tools.py

issue_in_branch_vip_token

運用

支店VIP昇格チケット（#RET-04）を発行し、支店2（支店長　Mr.Vikram Mehta）へ割り当て、WhatsAppで受付バウチャーを送信します。

📊 BigQuery APM とエージェント解析スイート

docs/ANALYTICS_QUERIES.md に記載された、完全な BigQuery Application Performance Monitoring（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

🚀 クイックスタートガイド

前提条件

  • Python: 3.11 から 3.13

  • Google Cloud SDK (gcloud): アクティブな GCP プロジェクトが設定されていること。

  • Google AlloyDB for PostgreSQL: 顧客およびポリシースキーマにアクセスできるクラスが存在すること。

Step 1: リポジトリのクローンと環境設定

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_logs

Google Cloud で認証します。

gcloud auth application-default login
gcloud config set project your-gcp-project-id

Step 2: ローカルで実行

chmod +x run.sh
./run.sh

ブラウザーで http://localhost:8080 を開き、キオスクツールとテレメトリーデッキを操作します。

🐳 Cloud Run へのデプロイ

モジュールツールサービスを、 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 の下で提供されています。詳細は LICENSE ファイルを参照してください。

This server cannot be installed

F
license - not found
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Azure AI MCP Server

    caiotk
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables comprehensive integration with Azure AI services including OpenAI, Cognitive Services, Computer Vision, and Face API through a mission-critical MCP server. Provides enterprise-grade reliability with high availability, observability, chaos engineering, and secure multi-region deployment capabilities.
    MIT

  • MCP Business AI Transformation

    Vovchansky6
    F
    license
    Not graded
    quality
    C
    maintenance
    Enterprise-grade MCP server with multi-agent system for business AI transformation across finance, healthcare, retail, and other domains. Provides specialized AI agents for data analysis, API execution, business validation, and report generation with real-time monitoring and observability.

  • COBOL Bridge MCP Server

    CSOAI-ORG
    A
    license
    Not graded
    quality
    Not graded
    maintenance
    Connects legacy COBOL mainframe systems to modern AI governance via MCP, with tools for parsing copybooks, assessing CICS, scanning JCL, mapping VSAM, and translating EBCDIC.
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Perspective AI

    An AI concierge that turns static forms into adaptive AI conversations. From any MCP client.

  • DATPAQ

    34 production API tools over one hosted MCP endpoint.

  • a2areplayreceipt-mcp

    Remote MCP for A2A failure replay MCP, structured receipts, audit logs, and reviewer-ready evidence.

View all MCP Connectors

Latest Blog Posts

MCP directory API

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