Skip to main content

MCP Admin Console

File: mcp_admin_console/server.py

The MCP Admin Console is a FastMCP server that exposes the CelerData BYOC admin console API as tools for Claude agents. It provides 100+ tools across 6 categories.

Architecture

Claude Agent --> MCP Protocol --> FastMCP Server --> AdminConsoleClient --> CelerData Admin API

Tool Categories

CategoryModuleDescription
Clusterstools/clusters.pyList, describe, diagnose clusters; query history; coredumps
Logstools/logs.pyStarRocks FE/BE logs, audit logs, platform service logs
Accountstools/accounts.pyAccounts, orgs, users, RBAC, cluster authorization
Billingtools/billing.pyBills, wallets, orders, discounts
Infrastructuretools/infrastructure.pyRegions, CSPs, AMIs, releases, VM types, volumes, tags
Operationstools/operations.pyMetrics, alarms, schedules, commands, reports, broadcasts

Investigation Workflow

The recommended sequence for investigating a cluster issue:

  1. list_clusters -- Find the cluster by name or account
  2. describe_cluster -- Get region, VM bizIds, state
  3. query_sr_logs -- Search FE/BE logs using vmBizId from step 2
  4. get_query_records -- View SQL query history

Running the Server

cd byocusage
python -m mcp_admin_console.server