Enables execution of SQL queries on PostgreSQL databases hosted on TimescaleDB Cloud, with support for query timeouts and table structure exploration.
Provides secure access to TimescaleDB Cloud databases with tools for executing SQL queries, listing tables, and retrieving table schema information.
MCP TimescaleDB Server
A Model Context Protocol (MCP) server for TimescaleDB Cloud that provides secure access to PostgreSQL databases.
Prerequisites
- Node.js (v16 or newer recommended)
- npm (comes with Node.js)
- TypeScript (installed as a dev dependency, but you may want it globally for development:
npm install -g typescript
)
A TimescaleDB Cloud account and credentials are also required.
Installation
- Install dependencies:
- Copy the environment template:
- Configure your TimescaleDB credentials in
.env
:
Building
Usage
Note: If you are using this server as part of an MCP client (see the "MCP Configuration" section below), you do not need to run
npm run dev
ornpm start
manually—the MCP client will launch the server automatically using the specified command. The scripts below are for local development and testing only.
Development
Production
MCP Configuration
Add this to your MCP client configuration:
Security
- All database connections use SSL/TLS encryption
- Credentials are managed through environment variables
- Connection timeouts are configurable
- Query timeouts prevent long-running queries
Available Tools
timescale_query
Execute SQL queries on TimescaleDB Cloud.
Parameters:
query
(string, required): SQL query to executetimeout
(number, optional): Query timeout in milliseconds
Example:
timescale_list_tables
List all tables in the current database.
Parameters:
schema
(string, optional): Schema name (defaults to 'public')
Example:
timescale_describe_table
Get table schema information.
Parameters:
table
(string, required): Table nameschema
(string, optional): Schema name (defaults to 'public')
Example:
Development
Project Structure
This server cannot be installed
Run queries and pull information about your TigerData Cloud's PostgreSQL databases
Related MCP Servers
- AsecurityAlicenseAqualityFacilitates management and optimization of PostgreSQL databases, offering analysis, setup guidance, and debugging, while ensuring secure and efficient database operations.Last updated -3116TypeScriptAGPL 3.0
- AsecurityAlicenseAqualityEnables AI models to interact with PostgreSQL databases through a standardized interface, supporting operations like queries, table manipulation, and schema inspection.Last updated -58815JavaScriptMIT License
- AsecurityAlicenseAqualityA server that connects to PostgreSQL databases and provides tools for safely exploring schemas, running read-only SQL queries, and performing data analysis with pre-built templates.Last updated -57381JavaScriptMIT License
Prisma MCP Serverofficial
-securityAlicense-qualityManage Prisma Postgres databases with easeLast updated -242,953TypeScriptApache 2.0