Skip to main content
Glama
siddontang

TiDB Cloud Zero MCP Server

by siddontang

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TIDB_URLNoMySQL connection string for your own TiDB Cloud instance (e.g., mysql://user:password@host/database)
TIDB_HOSTNoTiDB Cloud host (e.g., gateway01.us-west-2.prod.aws.tidbcloud.com)
TIDB_DATABASENoTiDB Cloud database name
TIDB_PASSWORDNoTiDB Cloud password
TIDB_USERNAMENoTiDB Cloud username

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
queryA

Execute a read-only SQL query (SELECT, SHOW, DESCRIBE, EXPLAIN).

Returns results as a formatted table.

Examples: query("SELECT * FROM users LIMIT 10") query("SHOW TABLES") query("DESCRIBE users")

executeA

Execute a write SQL statement (CREATE, INSERT, UPDATE, DELETE, ALTER, DROP).

Returns the number of affected rows.

Examples: execute("CREATE TABLE users (id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(255))") execute("INSERT INTO users (name) VALUES ('Alice')")

batch_executeA

Execute multiple SQL statements sequentially.

Args: statements: List of SQL statements to execute in order

Example: batch_execute([ "CREATE TABLE users (id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(255))", "INSERT INTO users (name) VALUES ('Alice')", "INSERT INTO users (name) VALUES ('Bob')" ])

list_tablesA

List all tables in the current database with row counts.

describe_tableA

Get the schema of a table (columns, types, keys).

Args: table: Table name to describe

get_database_infoA

Get database connection info, TiDB version, and instance status.

Prompts

Interactive templates invoked by user choice

NameDescription
create_crud_tableGenerate SQL to create a table with common CRUD patterns.
analyze_dataGenerate a data analysis workflow for a table.

Resources

Contextual data attached and managed by the client

NameDescription
resource_tablesList of all tables in the database.
resource_infoDatabase connection info and TiDB version.

TDQS

A4/5.0

Scored across 6 tools

Disambiguation3/5

Some overlap exists between query and list_tables/describe_table since query supports SHOW and DESCRIBE, which can duplicate those tools. However, the descriptions clarify the intended use cases, making selection mostly straightforward.

Naming Consistency4/5

Names use a consistent lowercase underscore style with imperative verbs, but mix single-word verbs (query, execute) with verb_noun pairs (list_tables, describe_table). This is a minor deviation from a fully uniform pattern.

Tool Count5/5

Six tools is well within the ideal range for a database server MCP, covering both read and write operations without being bloated.

Completeness5/5

The tool set covers core database operations: listing tables, describing schema, running read-only queries, executing write statements, batch execution, and retrieving server info. No obvious gaps for its stated purpose.

Maintenance

ActivityInactive
ResponsivenessNo issues