StarRocks MCP Server

StarRocks MCP サーバー

StarRocks データベースを操作するための Model Control Protocol（MCP）サーバーです。このサーバーは、定義済みのツール群を通じて AI モデルが StarRocks データベースにクエリを実行し、操作するための標準化されたインターフェースを提供します。

概要

StarRocks MCP サーバーを使用すると、AI モデルは次の操作を行えます。

• StarRocks データベースに SELECT クエリを実行する
• 利用可能なテーブルを一覧表示する
• テーブルスキーマを確認する
• 新しいテーブルを作成する（読み取り専用モードでない場合）
• INSERT、UPDATE、DELETE などの書き込み操作を実行する（読み取り専用モードでない場合）

インストール

前提条件

• Python 3.8+
• StarRocks データベースインスタンス
• SQLAlchemy
• MCP Python ライブラリ

ソースからインストール

git clone https://github.com/yourusername/mcp-server-starrocks.git
cd mcp-server-starrocks
pip install -e .

Smithery からインストール

npm install @smithery/sdk @modelcontextprotocol/sdk

MCP Inspector を使用する

npx @modelcontextprotocol/inspector uv --directory ~/mcp-server-starrocks run mcp-server-starrocks

使用方法

サーバーを起動する

python -m mcp_server_starrocks.server --host <starrocks-host> --port <starrocks-port> --user <username> --database <database-name> [--password <password>] [--readonly]

コマンドライン引数：

• --host：StarRocks サーバーのホスト（必須）
• --port：StarRocks サーバーのポート（デフォルト：9030）
• --user：StarRocks のユーザー名（必須）
• --database：StarRocks のデータベース名（必須）
• --password：StarRocks のパスワード（必要な場合）
• --readonly：サーバーを読み取り専用モードで実行する（任意）

利用可能なツール

サーバーは次のツールを提供します。

読み取り専用ツール：

• read-query：StarRocks データベースに SELECT クエリを実行する
• list-tables：StarRocks データベース内のすべてのテーブルを一覧表示する
• describe-table：指定したテーブルのスキーマを確認する

書き込みツール（読み取り専用モードでない場合に利用可能）：

• write-query：INSERT、UPDATE、DELETE クエリを実行する
• create-table：StarRocks データベースに新しいテーブルを作成する

例

テーブルを一覧表示する

{
    "name": "list-tables",
    "arguments": {}
}

SELECT クエリを実行する

{
    "name": "read-query",
    "arguments": {
        "query": "SELECT FROM my_table LIMIT 10"
    }
}

テーブルを確認する

{
    "name": "describe-table",
    "arguments": {
        "table_name": "my_table"
    }
}

テーブルを作成する（読み取り専用モードでない場合）

{
    "name": "create-table",
    "arguments": {
        "query": "CREATE TABLE new_table (id INT, name VARCHAR(100))"
    }
}

ライセンス

MIT ライセンス

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。