by timeplus-io
Integrate Timeplus for real-time analytics and understand the execution order of SQL queries to optimize your data explo
Connects to Timeplus databases to run SQL queries and manage real-time streaming data. Includes tools for exploring Kafka topics and setting up streaming ETL pipelines.
Timeplus is a community-built MCP server published by timeplus-io that provides AI assistants with tools and capabilities via the Model Context Protocol. Integrate Timeplus for real-time analytics and understand the execution order of SQL queries to optimize your data explo It is categorized under databases.
You can install Timeplus in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
Apache-2.0
Timeplus is released under the Apache-2.0 license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Enable Claude to query your database directly using natural language
Example
Ask 'Show me top 10 customers by revenue this month' and get SQL results instantly
Eliminate manual SQL writing for ad-hoc queries, get insights 10x faster
Generate complex reports and analytics without leaving conversation
Example
Analyze sales trends, cohort retention, user behavior patterns conversationally
Democratize data access—non-technical team members can query databases
Understand database structure, relationships, and data models
Example
'Explain the user_orders table schema and its relationships'
Onboard engineers faster, explore unfamiliar databases efficiently
Share your MCP server with the developer community
We wired Timeplus into a staging workspace; the listing’s GitHub and npm pointers saved time versus hunting across READMEs.
Useful MCP listing: Timeplus is the kind of server we cite when onboarding engineers to host + tool permissions.
Timeplus has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
According to our notes, Timeplus benefits from clear Model Context Protocol framing — fewer ambiguous “AI plugin” claims.
Timeplus reduced integration guesswork — categories and install configs on the listing matched the upstream repo.
Strong directory entry: Timeplus surfaces stars and publisher context so we could sanity-check maintenance before adopting.
We wired Timeplus into a staging workspace; the listing’s GitHub and npm pointers saved time versus hunting across READMEs.
We evaluated Timeplus against two servers with overlapping tools; this profile had the clearer scope statement.
Timeplus is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
We evaluated Timeplus against two servers with overlapping tools; this profile had the clearer scope statement.
showing 1-10 of 71
An MCP server for Timeplus.
<a href="https://glama.ai/mcp/servers/9aleefsq9s"><img width="380" height="200" src="https://glama.ai/mcp/servers/9aleefsq9s/badge" alt="mcp-timeplus MCP server" /></a>
generate_sql to give LLM more knowledge about how to query Timeplus via SQLrun_sql
sql (string): The SQL query to execute.readonly = 1 to ensure they are safe. If you want to run DDL or DML queries, you can set the environment variable TIMEPLUS_READ_ONLY to false.list_databases
list_tables
database (string): The name of the database.list_kafka_topics
explore_kafka_topic
topic (string): The name of the topic. message_count (int): The number of messages to show, default to 1.create_kafka_stream
topic (string): The name of the topic.connect_to_apache_iceberg
iceberg_db (string): The name of the Iceberg database. aws_account_id (int): The AWS account ID (12 digits). s3_bucket (string): The S3 bucket name. aws_region (string): The AWS region, default to "us-west-2". is_s3_table_bucket (bool): Whether the S3 bucket is a S3 table bucket, default to False.First, ensure you have the uv executable installed. If not, you can install it by following the instructions here.
Open the Claude Desktop configuration file located at:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%/Claude/claude_desktop_config.jsonAdd the following:
{
"mcpServers": {
"mcp-timeplus": {
"command": "uvx",
"args": ["mcp-timeplus"],
"env": {
"TIMEPLUS_HOST": "<timeplus-host>",
"TIMEPLUS_PORT": "<timeplus-port>",
"TIMEPLUS_USER": "<timeplus-user>",
"TIMEPLUS_PASSWORD": "<timeplus-password>",
"TIMEPLUS_SECURE": "false",
"TIMEPLUS_VERIFY": "true",
"TIMEPLUS_CONNECT_TIMEOUT": "30",
"TIMEPLUS_SEND_RECEIVE_TIMEOUT": "30",
"TIMEPLUS_READ_ONLY": "false",
"TIMEPLUS_KAFKA_CONFIG": "{"bootstrap.servers":"a.aivencloud.com:28864", "sasl.mechanism":"SCRAM-SHA-256","sasl.username":"avnadmin", "sasl.password":"thePassword","security.protocol":"SASL_SSL","enable.ssl.certificate.verification":"false"}"
}
}
}
}
Update the environment variables to point to your own Timeplus service.
You can also try this MCP server with other MCP clients, such as 5ire.
In test-services directory run docker compose up -d to start a Timeplus Proton server. You can also download it via curl https://install.timeplus.com/oss | sh, then start with ./proton server.
Add the following variables to a .env file in the root of the repository.
TIMEPLUS_HOST=localhost
TIMEPLUS_PORT=8123
TIMEPLUS_USER=default
TIMEPLUS_PASSWORD=
TIMEPLUS_SECURE=false
TIMEPLUS_VERIFY=true
TIMEPLUS_CONNECT_TIMEOUT=30
TIMEPLUS_SEND_RECEIVE_TIMEOUT=30
TIMEPLUS_READ_ONLY=false
TIMEPLUS_KAFKA_CONFIG={"bootstrap.servers":"a.aivencloud.com:28864", "sasl.mechanism":"SCRAM-SHA-256","sasl.username":"avnadmin", "sasl.password":"thePassword","security.protocol":"SASL_SSL","enable.ssl.certificate.verification":"false"}
Run uv sync to install the dependencies. Then do source .venv/bin/activate.
For easy testing, you can run mcp dev mcp_timeplus/mcp_server.py to start the MCP server. Click the "Connect" button to connect the UI with the MCP server, then switch to the "Tools" tab to run the available tools.
To build the Docker image, run docker build -t mcp_timeplus ..
The following environment variables are used to configure the Timeplus connection:
TIMEPLUS_HOST: The hostname of your Timeplus serverTIMEPLUS_USER: The username for authenticationTIMEPLUS_PASSWORD: The password for authenticationTIMEPLUS_PORT: The port number of your Timeplus server
8443 if HTTPS is enabled, 8123 if disabledTIMEPLUS_SECURE: Enable/disable HTTPS connection
"false""true" for secure connectionsTIMEPLUS_VERIFY: Enable/disable SSL certificate verification
"true""false" to disable certificate verification (not recommended for production)TIMEPLUS_CONNECT_TIMEOUT: Connection timeout in seconds
"30"TIMEPLUS_SEND_RECEIVE_TIMEOUT: Send/receive timeout in seconds
"300"TIMEPLUS_DATABASE: Default database to use
TIMEPLUS_READ_ONLY: Enable/disable read-only mode
"true""false" to enable DDL/DMLTIMEPLUS_KAFKA_CONFIG: A JSON string for the Kafka configuration. Please refer to librdkafka configuration or take the above example as a reference.Run data quality queries to catch anomalies and inconsistencies
Example
Find duplicate records, missing values, orphaned foreign keys automatically
Maintain data integrity with less manual SQL work
Prerequisites
Time Estimate
15-30 minutes including configuration and testing
Steps
Troubleshooting
✓ Do
✗ Don't
💡 Pro Tips
Architecture
MCP server acts as bridge between Claude and database, translating natural language to SQL queries and returning results in structured format.
Protocols
Compatibility
✓ Use when
Use for ad-hoc data queries, exploratory analysis, report generation, schema exploration, and democratizing data access. Best for read-heavy analytics workloads.
✗ Avoid when
Avoid for production write operations, mission-critical transactions, real-time OLTP workloads, or when database contains sensitive PII without proper access controls. Use read replicas, not primary.