MCP Server Starrocks

🚀 MCP サーバー設定

このドキュメントでは、MCP サーバーの設定方法と、関連するコンポーネントについて説明します。

🚀 クイックスタート

設定

MCP サーバーの設定は、JSON 形式で行います。以下は、mcp-server-starrocks の設定例です。

{
  "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 または ResultSet を持たないその他の StarRocks コマンドを実行します。

リソース

直接リソース

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

リソーステンプレート

• starrocks:///{db}/{table}/schema
  • SHOW CREATE TABLE を使用してテーブルのスキーマ情報を取得します。
• starrocks:///{db}/tables
  • 特定のデータベース内のすべてのテーブルを一覧表示します。
• proc:///{+path}
  • 星羅システムの内部情報を取得します。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 - カタログ情報を表示します。