TDengine Query MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Set the log level (DEBUG, INFO, WARN, ERROR) | INFO |
| TDENGINE_HOST | No | Database host for environment | localhost |
| TDENGINE_PORT | No | Database port | 6041 |
| TDENGINE_TIMEOUT | No | Set the connection timeout in seconds | 30 |
| TDENGINE_DATABASE | No | Database name | log |
| TDENGINE_PASSWORD | No | Database password | taosdata |
| TDENGINE_USERNAME | No | Database username | root |
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| test_table_existsB | Important: Check if the |
| get_all_dbsB | Get all databases. |
| get_all_stablesC | Get all stables. |
| switch_dbB | Switch to the specified database. |
| get_field_infosC | Get the field information of the specified stable. |
| query_taos_db_dataB | Important: Run a read-only SQL query on |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| taos_query | A guide to steer llm how to query Taos(涛思) database. |
| describe_query_prompt | Generate a prompt to ask an LLM to explain what a given SQL query does. Args: query: The SQL query string. Returns: A list containing a prompt message to explain the query. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| get_current_taos_database | Get current mysql database. |
| get_current_db_all_taos_schema | Provide all schema in the current database. |
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose with no overlap: get_all_dbs lists databases, get_all_stables lists stables, get_field_infos retrieves field details, query_taos_db_data executes SQL queries, switch_db changes database context, and test_table_exists checks stable existence. The descriptions clearly differentiate their functions, preventing agent misselection.
The naming follows a consistent snake_case pattern with clear verb_noun structures (e.g., get_all_dbs, switch_db, test_table_exists). The only minor deviation is query_taos_db_data, which includes 'taos_db' in the name while others omit it, but this doesn't significantly impact readability or predictability.
With 6 tools, this server is well-scoped for database querying and management. Each tool serves a specific, necessary function in the TDengine domain, from basic queries to metadata inspection and context switching, without being overly sparse or bloated.
The toolset covers core database operations effectively: querying data, listing databases and stables, inspecting schema, switching contexts, and checking existence. A minor gap is the lack of write operations (e.g., insert, update, delete), but for a query-focused server, the surface is largely complete and supports common agent workflows.