Starrocks MCP Server Starrocks

🚀 StarRocks 公式 MCP サーバー

StarRocks MCP サーバーは、AI アシスタントと StarRocks データベースの間の架け橋として機能し、複雑な設定や構成を必要とせずに、直接 SQL を実行したりデータベースを探索したりすることができます。

🚀 クイックスタート

📦 インストール

MCP サーバーの設定は以下の通りです。

{
  "mcpServers": {
    "mcp-server-starrocks": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-server-starrocks",
        "mcp-server-starrocks"
      ],
      "env": {
        "STARROCKS_HOST": "デフォルト localhost",
        "STARROCKS_PORT": "デフォルト 9030",
        "STARROCKS_USER": "デフォルト root",
        "STARROCKS_PASSWORD": "デフォルト空"
      }
    }
  }
}

もし mcp-server-starrocks が Python パッケージとしてインストールされていない場合（開発環境など）、ローカルディレクトリを使用して実行することができます。

{
  "mcpServers": {
    "mcp-server-starrocks": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/mcp-server-starrocks",
        "run",
        "mcp-server-starrocks"
      ],
      "env": {
        "STARROCKS_HOST": "デフォルト localhost",
        "STARROCKS_PORT": "デフォルト 9030",
        "STARROCKS_USER": "デフォルト root",
        "STARROCKS_PASSWORD": "デフォルト空"
      }
    }
  }
}

✨ 主な機能

ツール

• read_query

  • SELECT クエリまたはその他の ResultSet を返すコマンドを実行します。

• write_query

  • DDL/DML またはその他の StarRocks コマンドを実行します。これらのコマンドは ResultSet を返しません。

リソース

直接リソース

• starrocks:///databases
  • StarRocks 内のすべてのデータベースを一覧表示します。

リソーステンプレート

• starrocks:///{db}/{table}/schema

  • SHOW CREATE TABLE を使用してテーブルのスキーマ情報を取得します。

• starrocks:///{db}/tables

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

• proc:///{+path}

  • StarRocks が公開するシステム内部情報で、Linux の /proc ディレクトリに似ています。
  • 一般的なパスは以下の通りです：
    • /frontends - FE ノードの情報を表示します。
    • /backends - BE ノードの情報を表示します（非クラウドネイティブデプロイメントの場合のみ）。
    • /compute_nodes - CN ノードの情報を表示します（クラウドネイティブデプロイメントの場合）。
    • /dbs - データベース情報を表示します。
    • /dbs/<DB_ID> - データベース ID に基づいて特定のデータベースの情報を表示します。
    • /dbs/<DB_ID>/<TABLE_ID> - データベース ID とテーブル ID に基づいてテーブル情報を表示します。
    • /dbs/<DB_ID>/<TABLE_ID>/partitions - データベース ID とテーブル ID に基づいてパーティション情報を表示します。
    • /transactions - データベースごとに分類されたトランザクション情報を表示します。
    • /transactions/<DB_ID> - データベース ID に基づいてトランザクション情報を表示します。
    • /transactions/<DB_ID>/running - データベース ID に基づいて実行中のトランザクション情報を表示します。
    • /transactions/<DB_ID>/finished - データベース ID に基づいて完了したトランザクション情報を表示します。
    • /jobs - すべての一般タスクとその失敗タスクの合計を表示します。
    • /statistic - 各データベースの統計情報を表示します。
    • /tasks - すべての通常タスクとその失敗タスクの合計を表示します。
    • /cluster_balance - 負荷分散情報を表示します。
    • /routine_loads - Routine Load 情報を表示します。
    • /colocation_group - Colocate Join グループの情報を表示します。
    • /catalog - カタログ情報を表示します。

プロンプト

なし