Neura Market
jovezhong/mcp-timeplus logo

jovezhong/mcp-timeplus

Free

Apache Kafka 和 Timeplus 的 MCP 服务器。能列出 Kafka 主题、轮询消息、本地保存数据并通过 Timeplus 用 SQL 查询流数据。

FreeFree tier
Type
Open Source
Company
Timeplus
Visit Website GitHub (40 stars)

About jovezhong/mcp-timeplus

Timeplus MCP Server is an open-source MCP (Model Context Protocol) server that enables AI assistants like Claude Desktop to interact with Timeplus, a real-time streaming data platform. It provides a set of tools and prompts for executing SQL queries, managing databases, exploring Kafka topics, creating streaming ETL pipelines, and connecting to Apache Iceberg tables. The server is configured via environment variables and can be run using the uvx command. It bridges the gap between natural language interfaces and complex data workflows, allowing users to query streaming data, list Kafka topics, and save Kafka messages locally through simple conversational commands.

Key Features

Execute SQL queries on Timeplus clusters (read-only by default, configurable)
List databases and tables in a Timeplus cluster
List and explore Kafka topics, view sample messages
Create streaming ETL from Kafka to Timeplus to save messages locally
Connect to Apache Iceberg tables (Timeplus Enterprise, soon on Proton)
Generate SQL prompts to help LLMs construct Timeplus queries
Easy integration with Claude Desktop via MCP protocol
Configuration via environment variables (host, port, credentials, Kafka config)

Pros & Cons

Pros
  • Integrates seamlessly with Claude Desktop and other MCP clients
  • Supports both Timeplus and Kafka operations in one tool
  • Open source with easy setup using uvx
  • Includes a prompt to help LLMs generate correct SQL for Timeplus
  • Configurable read-only mode enhances safety for production use
Cons
  • Primarily designed for Timeplus users, limited value for other platforms
  • Requires a running Timeplus service (cloud or self-hosted)
  • Kafka features depend on external Kafka configuration in environment
  • Iceberg connectivity currently only available in Timeplus Enterprise

Best For

Querying real-time streaming data using natural language through AI assistantsManaging and exploring Kafka topics without using command-line toolsSetting up streaming ETL pipelines to persist Kafka messages into TimeplusConnecting Iceberg tables for OLAP workloads via Timeplus EnterpriseDatabase exploration and schema discovery for Timeplus clusters

FAQ

How do I install the Timeplus MCP Server?
Install using the uvx command: `uvx mcp-timeplus`. Ensure you have the `uv` executable installed first.
How do I configure the server for my Timeplus instance?
Set environment variables: TIMEPLUS_HOST, TIMEPLUS_PORT, TIMEPLUS_USER, TIMEPLUS_PASSWORD, and optionally TIMEPLUS_KAFKA_CONFIG for Kafka integration. Then add the configuration to Claude Desktop's claude_desktop_config.json.
What kind of queries can I run?
You can execute any SQL query on your Timeplus cluster. By default, queries run in read-only mode (TIMEPLUS_READ_ONLY=true). Set the environment variable to 'false' to allow DDL and DML queries.
Can I use this with other MCP clients besides Claude Desktop?
The server follows the MCP standard, so it should work with any MCP client, though the setup examples focus on Claude Desktop.