Skip to main content
Glama
mcp-timeplus

mcp-timeplus

by timeplus-io

Timeplus MCP サーバー

PyPI - バージョン

Timeplus 用の MCP サーバー。

特徴

プロンプト

  • generate_sql 、LLM に SQL 経由で Timeplus をクエリする方法に関するより多くの知識を与えます。

ツール

  • run_sql

    • Timeplus クラスターで SQL クエリを実行します。

    • 入力: sql (文字列): 実行する SQL クエリ。

    • デフォルトでは、すべてのTimeplusクエリは安全性を確保するためにreadonly = 1で実行されます。DDLまたはDMLクエリを実行する場合は、環境変数TIMEPLUS_READ_ONLYをfalseに設定できます。

  • list_databases

    • Timeplus クラスター上のすべてのデータベースを一覧表示します。

  • list_tables

    • データベース内のすべてのテーブルを一覧表示します。

    • 入力: database (文字列): データベースの名前。

  • list_kafka_topics

    • Kafka クラスター内のすべてのトピックを一覧表示する

  • explore_kafka_topic

    • Kafkaトピック内のいくつかのメッセージを表示する

    • 入力: topic (文字列): トピックの名前。 message_count (int): 表示するメッセージの数。デフォルトは 1。

  • create_kafka_stream

    • Timeplus でストリーミング ETL を設定し、Kafka メッセージをローカルに保存します。

    • 入力: topic (文字列): トピックの名前。

  • connect_to_apache_iceberg

    • Apache Icebergベースのデータベースに接続します。現在、この機能はTimeplus Enterpriseでのみ利用可能ですが、近日中にTimeplus Protonでも利用可能になる予定です。

    • 入力: iceberg_db (文字列): Iceberg データベースの名前。 aws_account_id (int): AWS アカウント ID (12 桁)。 s3_bucket (文字列): S3 バケット名。 aws_region (文字列): AWS リージョン。デフォルトは「us-west-2」。 is_s3_table_bucket (bool): S3 バケットが S3 テーブル バケットであるかどうか。デフォルトは False。

Related MCP server: KafkaIQ

構成

まず、 uv実行ファイルがインストールされていることを確認してください。まだインストールされていない場合は、こちらの手順に従ってインストールできます。

  1. 次の場所にある Claude Desktop 構成ファイルを開きます。

    • macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

  2. 以下を追加します。

{
  "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\"}"
      }
    }
  }
}

独自の Timeplus サービスを指すように環境変数を更新します。

  1. 変更を適用するには、Claude Desktop を再起動します。

この MCP サーバーを5ireなどの他の MCP クライアントで試すこともできます。

発達

  1. test-servicesディレクトリでdocker compose up -dを実行し、Timeplus Proton サーバーを起動します。または、 curl https://install.timeplus.com/oss | shでダウンロードし、 ./proton serverで起動することもできます。

  2. リポジトリのルートにある.envファイルに次の変数を追加します。

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"}
  1. uv syncを実行して依存関係をインストールします。その後、 source .venv/bin/activate実行します。

  2. 簡単なテストとして、 mcp dev mcp_timeplus/mcp_server.pyを実行してMCPサーバーを起動できます。「接続」ボタンをクリックしてUIをMCPサーバーに接続し、「ツール」タブに切り替えて利用可能なツールを実行してください。

  3. Docker イメージをビルドするには、 docker build -t mcp_timeplus . .

環境変数

Timeplus 接続を構成するには、次の環境変数が使用されます。

必須変数

  • TIMEPLUS_HOST : Timeplusサーバーのホスト名

  • TIMEPLUS_USER : 認証用のユーザー名

  • TIMEPLUS_PASSWORD : 認証用のパスワード

オプション変数

  • TIMEPLUS_PORT : Timeplusサーバーのポート番号

    • デフォルト: HTTPS が有効な場合は8443 、無効な場合は8123

    • 非標準ポートを使用しない限り、通常は設定する必要はありません

  • TIMEPLUS_SECURE : HTTPS接続を有効/無効にする

    • デフォルト: "false"

    • 安全な接続のために"true"に設定

  • TIMEPLUS_VERIFY : SSL証明書検証を有効/無効にする

    • デフォルト: "true"

    • 証明書の検証を無効にするには"false"に設定します(本番環境では推奨されません)

  • TIMEPLUS_CONNECT_TIMEOUT : 接続タイムアウト(秒)

    • デフォルト: "30"

    • 接続タイムアウトが発生する場合はこの値を増やしてください

  • TIMEPLUS_SEND_RECEIVE_TIMEOUT : 送受信タイムアウト(秒)

    • デフォルト: "300"

    • 長時間実行されるクエリの場合はこの値を増やします

  • TIMEPLUS_DATABASE : 使用するデフォルトのデータベース

    • デフォルト: なし (サーバーのデフォルトを使用)

    • 特定のデータベースに自動的に接続するにはこれを設定します

  • TIMEPLUS_READ_ONLY : 読み取り専用モードを有効/無効にする

    • デフォルト: "true"

    • DDL/DMLを有効にするには"false"に設定してください

  • TIMEPLUS_KAFKA_CONFIG : Kafka 設定用の JSON 文字列。librdkafka設定を参照するか、上記の例を参考にしてください。

Available Tools

7 tools
connect_to_apache_icebergC

Create a Timeplus database in iceberg type to connect to Iceberg

Inputs: iceberg_db (required), aws_account_id (required), s3_bucket (required), aws_region, +1 more.

create_kafka_streamD

Inputs: topic (required).

explore_kafka_topicD

Inputs: topic (required), message_count.

list_databasesA

List available Timeplus databases

Inputs: no named parameters.

list_kafka_topicsD

Inputs: no named parameters.

list_tablesC

List available tables/streams in the given database

Inputs: database, like.

run_sqlC

Run a query in a Timeplus database

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.4/5.0

    Scored across 7 tools

    Disambiguation3/5

    Most tools target distinct actions: listing databases, listing tables, running SQL, and connecting Iceberg are clearly separate. However, list_kafka_topics and explore_kafka_topic have overlapping territory around Kafka topics, and create_kafka_stream is adjacent to them; the empty descriptions worsen the ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in lowercase snake_case, such as list_databases, list_tables, and create_kafka_stream. The only slight deviation is connect_to_apache_iceberg, but it still follows the same verb-first convention.

    Tool Count5/5

    Seven tools is a well-scoped set for a Timeplus MCP server, covering database exploration, SQL execution, Kafka integration, and Iceberg connectivity without bloating the surface.

    Completeness4/5

    The toolset covers core querying, table/database listing, and Kafka stream ingestion plus Iceberg connection. Minor gaps exist around resource management (e.g., creating/dropping regular databases or streams), but the main read and integration workflows are supported.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage and monitor Apache Kafka clusters through natural language, providing real-time operations, health monitoring, consumer lag analysis, and temporal trend detection for intelligent cluster management.
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI agents to interact with Microsoft Fabric Real-Time Intelligence services, allowing for seamless data querying, analysis, and streaming capabilities.
      39
      5,551 PyPI
      134
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants to connect to 17+ databases and query/analyze data using natural language via MCP and HTTP APIs, supporting platforms like Claude Desktop, Cursor, and VS Code.
      42
      26 npm
      MIT