StarRocks

StarRocks

Interact with StarRocks

128
Stars
39
Forks
7
Releases

Overview

The StarRocks MCP Server acts as a bridge between AI assistants and StarRocks databases. It enables direct SQL execution, database exploration, data visualization via charts, and retrieving detailed schema and data overviews without requiring complex client-side setup. The server supports read_query and write_query operations for executing SELECTs, DDL, and DML commands, and provides tools like table_overview and db_overview to summarize table schemas, row counts, and sample data. It also exposes resources such as starrocks:///databases, starrocks:///{db}/{table}/schema, and proc:// paths to fetch internal metrics, metadata, and system information. For visualization, a query can be run and plotted with Plotly using query_and_plotly_chart. Results can be cached in memory to improve performance, with an option to bypass the cache. Configuration is flexible via environment variables or command-line arguments, including transport modes (stdio, streamable-http) and host/port settings. The server emphasizes Streamable HTTP for new integrations and notes that SSE mode is deprecated.

Details

Owner
StarRocks
Language
Python
License
Apache License 2.0
Updated
2025-12-07

Features

Direct SQL Execution

Run SELECT queries (read_query) and DDL/DML commands (write_query) against StarRocks.

Database Exploration

List databases and tables and retrieve table schemas via starrocks:// resources.

System Information

Access internal StarRocks metrics and states through the proc:// resource path.

Detailed Overviews

Get comprehensive table_overview or db_overview summaries including column definitions, row counts, and sample data.

Data Visualization

Execute a query and generate a Plotly chart directly from the results using query_and_plotly_chart.

Intelligent Caching

Cache table and database overviews in memory to speed up repeated requests; bypass cache when needed.

Flexible Configuration

Configure connection details and behavior via environment variables and command-line options.

Tags

StarRocksMCPSQLDatabase ExplorationData VisualizationPlotlyCachingStreamable HTTPProc Resources