シングルストア MCP サーバー
モデルコンテキストプロトコル（MCP）は、大規模言語モデル（LLM）と外部システム間のコンテキストを管理するために設計された標準化されたプロトコルです。このリポジトリは、Singlestore用のインストーラーとMCPサーバーを提供し、シームレスな統合を実現します。
MCP を使用すると、Claude Desktop、Cursor、または互換性のある MCP クライアントを使用して自然言語で SingleStore と対話できるため、複雑な操作を簡単に実行できます。
要件
Python >= v3.11.0
Python環境にuvxがインストールされている
Claude Desktop、Cursor、またはサポートされている他のLLMクライアント
Related MCP server: MCP Server Example
クライアントのセットアップ
1. 初期化コマンド
MCP サーバーをセットアップする最も簡単な方法は、初期化コマンドを使用することです。
このコマンドは次のことを行います。
ユーザーを認証する
プラットフォームの設定ファイルを自動的に見つける
SingleStore MCP サーバーを含むように構成を作成または更新します
サーバーの起動手順を説明します
<SINGLESTORE_API_KEY>を明示的に渡すこともできます。
クライアント (例: claudeまたはcursor ) を指定するには、 --clientフラグを使用します。
2. Smithery経由でインストールする
Smithery経由でmcp-server-singlestore自動的にインストールするには:
必要に応じて、 <client>をclaudeまたはcursorに置き換えます。
3. 手動設定
クロード・デスクトップとカーソル
クライアント構成ファイルに次の構成を追加します。
- { "mcpServers": { "singlestore-mcp-server": { "command": "uvx", "args": [ "singlestore-mcp-server", "start", "<SINGLESTORE_API_KEY>" ] } } }
設定を変更した後は、クライアントを再起動してください。
コンポーネント
ツール
サーバーは次のツールを実装します。
workspace_groups_info : ユーザーがアクセスできるワークスペースグループの詳細を取得します。
引数は必要ありません
ワークスペースグループの詳細を返します
workspaces_info : 特定のワークスペースグループ内のワークスペースの詳細を取得します。
引数:
workspaceGroupID(文字列)ワークスペースの詳細を返します
organization_info : ユーザーの現在の組織に関する詳細を取得します
引数は必要ありません
組織の詳細を返します
list_of_regions : ユーザーのワークスペースをサポートするすべてのリージョンのリストを取得します。
引数は必要ありません
地域のリストを返します
execute_sql : 接続されたワークスペースでSQL操作を実行する
引数:
workspace_group_identifier、workspace_identifier、username、password、database、sql_querySQLクエリの結果を構造化された形式で返します
list_virtual_workspaces : ユーザーがアクセスできるすべてのスターターワークスペースを一覧表示します
引数は必要ありません
利用可能なスターターワークスペースの詳細を返します
create_virtual_workspace : ユーザーで新しいスターターワークスペースを作成する
引数:
name: スターターワークスペースの名前database_name: 作成するデータベースの名前username: ワークスペースにアクセスするためのユーザー名password: ユーザーのパスワードworkspace_group:name（オプション）とcellID（必須）を含むオブジェクト
作成されたワークスペースとユーザーの詳細を返します
execute_sql_on_virtual_workspace : 仮想ワークスペースでSQL操作を実行する
引数:
virtual_workspace_id、username、password、sql_queryデータ、行数、列、ステータスを含む構造化された形式でSQLクエリの結果を返します。
list_notebook_samples : SingleStore Spaces で利用可能なすべてのノートブックのサンプルを一覧表示します
引数は必要ありません
利用可能なノートブックのサンプルの詳細を返します
create_notebook : ユーザーの個人スペースに新しいノートブックを作成する
引数:
notebook_name、content（オプション）作成されたノートブックの詳細を返します
list_personal_files : ユーザーの個人スペース内のすべてのファイルを一覧表示する
引数は必要ありません
ユーザーの個人スペースにあるすべてのファイルの詳細を返します
create_scheduled_job : ノートブックを実行するための新しいスケジュールされたジョブを作成する
引数:
name: ジョブの名前notebook_path: 実行するノートブックへのパスschedule_mode: 1回または定期execution_interval_minutes: 実行間隔（分）（オプション）start_at: ジョブを開始するタイミング（オプション）description: ジョブの説明（オプション）create_snapshot: ノートブックのスナップショットを作成するかどうか（オプション）runtime_name環境の名前parameters: ジョブのパラメータ（オプション）target_config: ジョブのターゲット構成（オプション）
作成されたジョブの詳細を返します
get_job_details : 特定のジョブの詳細を取得する
引数:
job_id指定されたジョブの詳細情報を返します
list_job_executions : 特定のジョブの実行履歴を一覧表示する
引数:
job_id、start（オプション）、end（オプション）指定されたジョブの実行履歴を返します
ドッカー化
Dockerイメージの構築
MCP サーバーの Docker イメージをビルドするには、プロジェクト ルートで次のコマンドを実行します。
Dockerコンテナの実行
Docker コンテナを実行するには、次のコマンドを使用します。
Docker Secretsの使用
シークレットをコンテナに安全に渡すには、Docker シークレットを作成してマウントします。
次に、シークレットを使用してコンテナを実行します。