Log inSubmit server
MCP Timeplus logo

MCP Timeplus

by jovezhong

Runs read-only ClickHouse SQL queries and exposes database and table discovery through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Timeplus

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "jovezhong-mcp-timeplus": {
      "command": "uvx",
      "args": [
        "mcp-timeplus"
      ],
      "env": {
        "CLICKHOUSE_HOST": "YOUR_VALUE_HERE",
        "CLICKHOUSE_USER": "YOUR_VALUE_HERE",
        "CLICKHOUSE_PASSWORD": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx mcp-timeplus

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked Today.

Overview

jovezhong/mcp-timeplus MCP server exposes database discovery and SQL query tools through MCP. The README configures it to connect to ClickHouse using environment variables for host, credentials, security, and timeouts. Reach for it when an agent needs read-only ClickHouse queries and schema discovery from an MCP-compatible client.

Use cases

  • Query ClickHouse data with read-only SQL
  • List available ClickHouse databases
  • Inspect tables within a database
  • Connect an MCP client to a configured ClickHouse service

Key features

  • Read-only ClickHouse SQL execution
  • Database listing
  • Table listing by database
  • Configurable TLS and certificate verification
  • Configurable connection and query timeouts
  • Claude Desktop stdio configuration

Tools18

What MCP Timeplus lets your agent do. Expand a tool for its parameters.

Self-reported~56 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

4/4 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · mcp-timeplus (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars12Stargazers on the source repository.
Last commit1y agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed18Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Timeplus works

What jovezhong/mcp-timeplus MCP server does

jovezhong/mcp-timeplus MCP server exposes database and SQL operations to an MCP client. The README identifies the implementation as a ClickHouse MCP server and documents connections to a ClickHouse cluster.

The documented workflow is oriented toward inspection and querying rather than data mutation. SQL sent through run_select_query is executed with ClickHouse readonly = 1, which limits the documented query path to read-only operations.

How it works

An MCP client starts the server with uv run, supplies connection settings through environment variables, and invokes the exposed tools. The documented tools are:

  • run_select_query: executes a SQL statement against the configured ClickHouse cluster.
  • list_databases: returns the databases available on that cluster.
  • list_tables: returns tables for a database supplied as an input.

The supplied tool inventory also lists sql and database.

Setup and configuration

The command uses uv with the mcp-clickhouse package and Python 3.13. Replace the placeholder connection values with those for the target ClickHouse service, then restart Claude Desktop.

CLICKHOUSE_HOST, CLICKHOUSE_USER, and CLICKHOUSE_PASSWORD are required by the documented configuration. CLICKHOUSE_PORT, CLICKHOUSE_SECURE, and CLICKHOUSE_VERIFY control the endpoint and TLS behavior. CLICKHOUSE_CONNECT_TIMEOUT and CLICKHOUSE_SEND_RECEIVE_TIMEOUT set connection and query communication limits, while CLICKHOUSE_DATABASE selects a default database. The documented defaults use port 8443 for secure connections and 8123 for non-secure connections.

Limitations and notes

The repository name and listing refer to jovezhong/mcp-timeplus MCP server, Apache Kafka, and Timeplus, while the README title, package name, configuration variables, and documented tools refer to ClickHouse. Confirm the repository’s current implementation before depending on Kafka or Timeplus-specific behavior.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Timeplus

jovezhong/mcp-timeplus is an MCP server that connects an MCP client to ClickHouse according to its README, with tools for read-only SQL execution, database listing, and table listing.

Install and run it with `uv` using the documented `uv run --with mcp-clickhouse --python 3.13 mcp-clickhouse` command. Provide the ClickHouse environment variables, add the command to the MCP client's configuration, and restart the client.

Set `CLICKHOUSE_HOST`, `CLICKHOUSE_USER`, and `CLICKHOUSE_PASSWORD` as the required connection variables. You can also configure the port, TLS, certificate verification, timeouts, and default database with the optional ClickHouse variables documented in the README.

Yes, the README provides a Claude Desktop stdio configuration. Add the server command and ClickHouse environment variables to `claude_desktop_config.json`, use the absolute path to `uv` if needed, and restart Claude Desktop.

The documented query tool is read-only because ClickHouse queries run with `readonly = 1`.

Related MCP servers

All in Data Platforms All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Timeplus AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/jovezhong-mcp-timeplus?style=directory)](https://allmcps.com/mcp/jovezhong-mcp-timeplus)
HTML Embed
<a href="https://allmcps.com/mcp/jovezhong-mcp-timeplus"><img src="https://allmcps.com/api/badge/jovezhong-mcp-timeplus?style=directory" alt="MCP Timeplus on AllMCPs" /></a>