mcp-server-starrocks

StarRocks MCPサーバーは、AIアシスタントとStarRocksデータベースの間の橋渡しを行います。複雑なクライアント側の設定なしで、SQLの直接実行、データベースの探索、データの可視化を可能にします。システム情報へのアクセスや詳細なテーブル・データベースの概要を取得する機能も備えています。

GitHubスター

115

ユーザー評価

未評価

お気に入り

0

閲覧数

17

フォーク

34

イシュー

1

インストール方法
難易度
中級
推定所要時間
10-20
必要な環境
Python 3.7以上
StarRocks 最新版

インストール方法

インストール方法

前提条件

必要なソフトウェアとバージョン:
Python: 3.7以上
StarRocks: 最新版

インストール手順

1. リポジトリのクローン

bash
git clone https://github.com/StarRocks/mcp-server-starrocks
cd mcp-server-starrocks

2. 依存関係のインストール

bash
pip install -r requirements.txt

3. サーバーの起動

bash
uv run --with mcp-server-starrocks mcp-server-starrocks

トラブルシューティング

よくある問題

問題: サーバーが起動しない 解決策: Pythonのバージョンを確認し、依存関係を再インストールしてください。 問題: データベース接続エラー 解決策: 環境変数の設定を確認してください。

設定方法

設定方法

基本設定

MCPサーバー設定

以下の設定ファイルを編集して、StarRocks MCPサーバーの接続詳細を指定します。
json
{
  "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": "",
        "STARROCKS_DB": "",
        "STARROCKS_OVERVIEW_LIMIT": "20000",
        "STARROCKS_MYSQL_AUTH_PLUGIN": "mysql_clear_password"
      }
    }
  }
}

環境変数

必要に応じて以下の環境変数を設定:
bash
export STARROCKS_HOST="localhost"
export STARROCKS_PORT="9030"

使用例

使用例

基本的な使用方法

MCPサーバーの基本的な使用方法を以下に示します:

SQLクエリの実行

python
import requests

response = requests.post('http://localhost:3000/mcp/call', json={
    'tool': 'read_query',
    'parameters': {'query': 'SELECT * FROM my_table'}
})
print(response.json())

データ視覚化

python
import requests
import json

response = requests.post('http://localhost:3000/mcp/call', json={
    'tool': 'query_and_plotly_chart',
    'parameters': {'query': 'SELECT * FROM my_table'}
})
chart_data = response.json()

ここでchart_dataを使ってPlotlyでチャートを描画

使用ケース

AIアシスタントを使用して、データベースからの情報をリアルタイムで取得する。
データ分析のために、SQLクエリを直接実行して結果を視覚化する。
データベースのスキーマを探索し、アプリケーションの開発に役立てる。
システムの内部メトリクスを監視し、パフォーマンスを最適化する。

追加リソース

作者情報

364

フォロワー

41

リポジトリ

0

Gist

0

貢献数