SingleStore MCP Server

シングルストア MCP サーバー

モデルコンテキストプロトコル（MCP）は、大規模言語モデル（LLM）と外部システム間のコンテキストを管理するために設計された標準化されたプロトコルです。このリポジトリは、Singlestore用のインストーラーとMCPサーバーを提供し、シームレスな統合を実現します。

MCP を使用すると、Claude Desktop、Cursor、または互換性のある MCP クライアントを使用して自然言語で SingleStore と対話できるため、複雑な操作を簡単に実行できます。

要件

• Python >= v3.11.0
• Python環境にuvxがインストールされている
• Claude Desktop、Cursor、またはサポートされている他のLLMクライアント

クライアントのセットアップ

1. 初期化コマンド

MCP サーバーをセットアップする最も簡単な方法は、初期化コマンドを使用することです。

このコマンドは次のことを行います。

1. ユーザーを認証する
2. プラットフォームの設定ファイルを自動的に見つける
3. SingleStore MCP サーバーを含むように構成を作成または更新します
4. サーバーの起動手順を説明します

<SINGLESTORE_API_KEY>を明示的に渡すこともできます。

クライアント (例: claudeまたはcursor ) を指定するには、 --clientフラグを使用します。

2. Smithery経由でインストールする

Smithery経由でmcp-server-singlestore自動的にインストールするには:

必要に応じて、 <client>をclaudeまたはcursorに置き換えます。

3. 手動設定

クロード・デスクトップとカーソル

1. クライアント構成ファイルに次の構成を追加します。

• クロードデスクトップ:
• カーソル
  { "mcpServers": { "singlestore-mcp-server": { "command": "uvx", "args": [ "singlestore-mcp-server", "start", "<SINGLESTORE_API_KEY>" ] } } }

2. 設定を変更した後は、クライアントを再起動してください。

コンポーネント

ツール

サーバーは次のツールを実装します。

• workspace_groups_info : ユーザーがアクセスできるワークスペースグループの詳細を取得します。
  • 引数は必要ありません
  • ワークスペースグループの詳細を返します
• workspaces_info : 特定のワークスペースグループ内のワークスペースの詳細を取得します。
  • 引数: workspaceGroupID (文字列)
  • ワークスペースの詳細を返します
• organization_info : ユーザーの現在の組織に関する詳細を取得します
  • 引数は必要ありません
  • 組織の詳細を返します
• list_of_regions : ユーザーのワークスペースをサポートするすべてのリージョンのリストを取得します。
  • 引数は必要ありません
  • 地域のリストを返します
• execute_sql : 接続されたワークスペースでSQL操作を実行する
  • 引数: workspace_group_identifier 、 workspace_identifier 、 username 、 password 、 database 、 sql_query
  • SQLクエリの結果を構造化された形式で返します
• 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 シークレットを作成してマウントします。

次に、シークレットを使用してコンテナを実行します。