Starrocks MCP Server

🚀 星辰 rocks 公式 MCP サーバー

星辰 rocks MCP サーバーは、AI アシスタントと星辰 rocks データベースの間の橋渡しとして機能し、複雑な設定や構成を必要とせずに直接 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 または ResultSet を持たないその他の星辰 rocks コマンドを実行します。

リソース

直接リソース

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

リソーステンプレート

• starrocks:///{db}/{table}/schema
  • SHOW CREATE TABLE を使用してテーブルのスキーマ情報を取得します。
• starrocks:///{db}/tables
  • 特定のデータベース内のすべてのテーブルを一覧表示します。
• proc:///{+path}
  • 星辰 rocks が公開するシステム内部情報で、linux の /proc に似ています。
  • 一般的なパスは以下の通りです。
    • /frontends - FE ノードの情報を表示します。
    • /backends - 非クラウドネイティブデプロイの場合、BE ノードの情報を表示します。
    • /compute_nodes - クラウドネイティブデプロイの場合、CN ノードの情報を表示します。
    • /dbs - データベースの情報を表示します。
    • /dbs/<DB_ID> - データベース ID に基づいてデータベース情報を表示します。
    • /dbs/<DB_ID>/<TABLE_ID> - データベースとテーブル ID に基づいてテーブル情報を表示します。
    • /dbs/<DB_ID>/<TABLE_ID>/partitions - データベースとテーブル ID に基づいてパーティション情報を表示します。
    • /transactions - 各データベースのトランザクション情報を表示します。
    • /transactions/<DB_ID> - データベース ID に基づいてトランザクション情報を表示します。
    • /transactions/<DB_ID>/running - データベース ID に基づいて実行中のトランザクション情報を表示します。
    • /transactions/<DB_ID>/finished - データベース ID に基づいて完了したトランザクション情報を表示します。
    • /jobs - すべてのワークフローの情報を表示します。
    • /statistic - 各データベースの統計情報を表示します。
    • /tasks - すべての汎用タスクと失敗したタスクの数を表示します。
    • /cluster_balance - クラスターの負荷分散情報を表示します。
    • /routine_loads - 定期的なロード情報を表示します。
    • /colocation_group - colocate join グループの情報を表示します。
    • /catalog - カタログの情報を表示します。