remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

The MCP server is available as a package on PyPI, allowing users to install it using package managers.

Timeplus MCP サーバー

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。

構成

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

次の場所にある Claude Desktop 構成ファイルを開きます。
- macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows の場合: %APPDATA%/Claude/claude_desktop_config.json
以下を追加します。

{
  "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 サービスを指すように環境変数を更新します。

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

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

発達

test-servicesディレクトリでdocker compose up -dを実行し、Timeplus Proton サーバーを起動します。または、 curl https://install.timeplus.com/oss | shでダウンロードし、 ./proton serverで起動することもできます。
リポジトリのルートにある.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"}

uv syncを実行して依存関係をインストールします。その後、 source .venv/bin/activate実行します。
簡単なテストとして、 mcp dev mcp_timeplus/mcp_server.pyを実行してMCPサーバーを起動できます。「接続」ボタンをクリックしてUIをMCPサーバーに接続し、「ツール」タブに切り替えて利用可能なツールを実行してください。
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設定を参照するか、上記の例を参考にしてください。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Apache Kafka/Pulsarなどのストリーミングデータ用データベースであるTimeplusとの統合

Related Resources

Reddit Discussion about this server