Skip to main content
Glama
SingleStore MCP Server

SingleStore MCP Server

SingleStore MCP-Server

MIT Licence PyPI Downloads

Das Model Context Protocol (MCP) ist ein standardisiertes Protokoll, das entwickelt wurde, um den Kontext zwischen großen Sprachmodellen (LLMs) und externen Systemen zu verwalten. Dieses Repository stellt einen Installer und einen MCP-Server für SingleStore bereit, um eine nahtlose Integration zu ermöglichen.

Mit MCP können Sie Claude Desktop, Claude Code, Cursor oder jeden anderen kompatiblen MCP-Client verwenden, um mit SingleStore in natürlicher Sprache zu interagieren, was die Durchführung komplexer Vorgänge mühelos erleichtert.

💡 Profi-Tipp: Sie sind sich nicht sicher, was der MCP-Server tun kann? Rufen Sie einfach den /help-Befehl in Ihrem Chat auf!

Anforderungen

  • Python >= v3.10.0

  • uvx in Ihrer Python-Umgebung installiert

  • VS Code, Cursor, Windsurf, Claude Desktop, Claude Code, Goose oder ein anderer MCP-Client

Related MCP server: ExecuteAutomation Database Server

Erste Schritte

Erste Schritte

Installieren Sie zunächst den SingleStore MCP-Server mit Ihrem Client.

Die Standardkonfiguration funktioniert in den meisten Tools:

{
  "mcpServers": {
    "singlestore-mcp-server": {
      "command": "uvx",
      "args": [
        "singlestore-mcp-server",
        "start"
      ]
    }
  }
}

Keine API-Schlüssel, Token oder Umgebungsvariablen erforderlich! Der Server übernimmt die Authentifizierung beim Start automatisch über OAuth im Browser.

Automatische Einrichtung:

uvx singlestore-mcp-server init --client=claude-desktop

Manuelle Einrichtung: Folgen Sie der MCP-Installationsanleitung und verwenden Sie die oben genannte Standardkonfiguration.

Automatische Einrichtung:

uvx singlestore-mcp-server init --client=claude-code

Dies führt den Claude CLI-Befehl automatisch für Sie aus.

Manuelle Einrichtung:

claude mcp add singlestore-mcp-server uvx singlestore-mcp-server start

Automatische Einrichtung:

uvx singlestore-mcp-server init --client=cursor

Manuelle Einrichtung: Gehen Sie zu Cursor Settings -> MCP -> Add new MCP Server. Vergeben Sie einen Namen Ihrer Wahl und verwenden Sie den Typ command mit dem Befehl uvx singlestore-mcp-server start. Sie können die Konfiguration auch überprüfen oder Befehlszeilenargumente hinzufügen, indem Sie auf Edit klicken.

Automatische Einrichtung:

uvx singlestore-mcp-server init --client=vscode

Manuelle Einrichtung: Folgen Sie der MCP-Installationsanleitung und verwenden Sie die oben genannte Standardkonfiguration. Sie können die Installation auch über die VS Code CLI vornehmen:

code --add-mcp '{"name":"singlestore-mcp-server","command":"uvx","args":["singlestore-mcp-server","start"]}'

Nach der Installation steht der SingleStore MCP-Server für die Verwendung mit Ihrem GitHub Copilot-Agenten in VS Code zur Verfügung.

Automatische Einrichtung:

uvx singlestore-mcp-server init --client=windsurf

Manuelle Einrichtung: Folgen Sie der Windsurf MCP-Dokumentation. Verwenden Sie die oben genannte Standardkonfiguration.

Automatische Einrichtung:

uvx singlestore-mcp-server init --client=gemini

Manuelle Einrichtung: Folgen Sie der MCP-Installationsanleitung und verwenden Sie die oben genannte Standardkonfiguration.

Automatische Einrichtung:

uvx singlestore-mcp-server init --client=lm-studio

Manuelle Einrichtung: Gehen Sie in der rechten Seitenleiste zu Program -> Install -> Edit mcp.json. Verwenden Sie die oben genannte Standardkonfiguration.

Nur manuelle Einrichtung: Gehen Sie zu Advanced settings -> Extensions -> Add custom extension. Vergeben Sie einen Namen Ihrer Wahl, verwenden Sie den Typ STDIO und setzen Sie den command auf uvx singlestore-mcp-server start. Klicken Sie auf "Add Extension".

Nur manuelle Einrichtung: Öffnen Sie das Qodo Gen Chat-Panel in VSCode oder IntelliJ → Connect more tools → + Add new MCP → Fügen Sie die oben genannte Standardkonfiguration ein.

Klicken Sie auf Save.

Verwendung von Docker

HINWEIS: Bei der Verwendung von Docker ist ein API-Schlüssel erforderlich, da der OAuth-Flow für Server, die in Docker-Containern ausgeführt werden, nicht unterstützt wird.

{
  "mcpServers": {
    "singlestore-mcp-server": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--init", "--pull=always",
        "-e", "MCP_API_KEY=your_api_key_here",
        "singlestore/mcp-server-singlestore"
      ]
    }
  }
}

Sie können das Docker-Image selbst erstellen:

docker build -t singlestore/mcp-server-singlestore .

Für eine bessere Sicherheit empfehlen wir die Verwendung von Docker Desktop zur Konfiguration des SingleStore MCP-Servers – weitere Informationen finden Sie in diesem Blogbeitrag zum neuen MCP-Katalog von Docker.

Komponenten

Tools

Der Server implementiert die folgenden Tools:

  • get_user_info: Details über den aktuellen Benutzer abrufen

    • Keine Argumente erforderlich

    • Gibt Benutzerinformationen und Details zurück

  • organization_info: Details über die aktuelle Organisation des Benutzers abrufen

    • Keine Argumente erforderlich

    • Gibt Details der Organisation zurück

  • choose_organization: Aus verfügbaren Organisationen wählen (nur verfügbar, wenn die Umgebungsvariable für den API-Schlüssel nicht gesetzt ist)

    • Keine Argumente erforderlich

    • Gibt eine Liste der verfügbaren Organisationen zur Auswahl zurück

  • set_organization: Die aktive Organisation festlegen (nur verfügbar, wenn die Umgebungsvariable für den API-Schlüssel nicht gesetzt ist)

    • Argumente: organization_id (Zeichenfolge)

    • Legt die angegebene Organisation als aktiv fest

  • workspace_groups_info: Details über die für den Benutzer zugänglichen Arbeitsbereichsgruppen abrufen

    • Keine Argumente erforderlich

    • Gibt Details der Arbeitsbereichsgruppen zurück

  • workspaces_info: Details über die Arbeitsbereiche in einer bestimmten Arbeitsbereichsgruppe abrufen

    • Argumente: workspace_group_id (Zeichenfolge)

    • Gibt Details der Arbeitsbereiche zurück

  • resume_workspace: Einen angehaltenen Arbeitsbereich fortsetzen

    • Argumente: workspace_id (Zeichenfolge)

    • Setzt den angegebenen Arbeitsbereich fort

  • list_starter_workspaces: Alle für den Benutzer zugänglichen Starter-Arbeitsbereiche auflisten

    • Keine Argumente erforderlich

    • Gibt Details der verfügbaren Starter-Arbeitsbereiche zurück

  • create_starter_workspace: Einen neuen Starter-Arbeitsbereich erstellen

    • Argumente: Konfigurationsparameter für den Arbeitsbereich

    • Gibt Details des erstellten Starter-Arbeitsbereichs zurück

  • terminate_starter_workspace: Einen bestehenden Starter-Arbeitsbereich beenden

    • Argumente: workspace_id (Zeichenfolge)

    • Beendet den angegebenen Starter-Arbeitsbereich

  • list_regions: Eine Liste aller Regionen abrufen, die Arbeitsbereiche unterstützen

    • Keine Argumente erforderlich

    • Gibt eine Liste der verfügbaren Regionen zurück

  • list_sharedtier_regions: Eine Liste der Shared-Tier-Regionen abrufen

    • Keine Argumente erforderlich

    • Gibt eine Liste der Shared-Tier-Regionen zurück

  • run_sql: SQL-Operationen auf einem verbundenen Arbeitsbereich ausführen

    • Argumente: workspace_id, database, sql_query und Verbindungsparameter

    • Gibt die Ergebnisse der SQL-Abfrage in einem strukturierten Format zurück

  • create_notebook_file: Eine neue Notebook-Datei in SingleStore Spaces erstellen

    • Argumente: notebook_name, content (optional)

    • Gibt Details des erstellten Notebooks zurück

  • upload_notebook_file: Eine Notebook-Datei in SingleStore Spaces hochladen

    • Argumente: file_path, notebook_name

    • Gibt Details des hochgeladenen Notebooks zurück

  • create_job_from_notebook: Einen geplanten Job aus einem Notebook erstellen

    • Argumente: Job-Konfiguration einschließlich notebook_path, schedule_mode usw.

    • Gibt Details des erstellten Jobs zurück

  • get_job: Details eines bestehenden Jobs abrufen

    • Argumente: job_id (Zeichenfolge)

    • Gibt Details des angegebenen Jobs zurück

  • delete_job: Einen bestehenden Job löschen

    • Argumente: job_id (Zeichenfolge)

    • Löscht den angegebenen Job

  • stage_list_files: Dateien und Ordner im Dateisystem einer Stage-Bereitstellung auflisten

    • Argumente: deployment_id (Zeichenfolge), path (Zeichenfolge, optional)

    • Gibt Ordnerinhalte einschließlich Dateien und Unterordnern zurück

  • stage_get_file: Eine Datei aus Stage über den Pfad abrufen

    • Argumente: deployment_id (Zeichenfolge), path (Zeichenfolge), return_type (Zeichenfolge: 'metadata', 'url' oder 'content')

    • Gibt Dateimetadaten, eine Download-URL oder Textinhalt zurück

  • stage_create_folder: Einen Ordner in Stage erstellen

    • Argumente: deployment_id (Zeichenfolge), path (Zeichenfolge)

    • Gibt den Erstellungsstatus zurück

  • stage_upload_file: Eine Datei mit Textinhalt in Stage hochladen

    • Argumente: deployment_id (Zeichenfolge), path (Zeichenfolge), content (Zeichenfolge), local_path (Zeichenfolge)

    • Gibt den Upload-Status zurück

  • stage_move: Eine Datei oder einen Ordner in Stage verschieben oder umbenennen

    • Argumente: deployment_id (Zeichenfolge), source_path (Zeichenfolge), destination_path (Zeichenfolge)

    • Gibt den Verschiebungsstatus zurück

  • stage_delete: Eine Datei oder einen Ordner aus Stage löschen

    • Argumente: deployment_id (Zeichenfolge), path (Zeichenfolge)

    • Gibt den Löschstatus zurück

Hinweis: Tools zur Organisationsverwaltung (choose_organization und set_organization) sind nur verfügbar, wenn die Umgebungsvariable für den API-Schlüssel nicht gesetzt ist, was eine interaktive Auswahl der Organisation während der OAuth-Authentifizierung ermöglicht.

Entwicklung

Voraussetzungen

  • Python >= 3.11

  • uv für das Abhängigkeitsmanagement

Einrichtung

  1. Repository klonen:

git clone https://github.com/singlestore-labs/mcp-server-singlestore.git
cd mcp-server-singlestore
  1. Abhängigkeiten installieren:

uv sync --dev
  1. Pre-commit-Hooks einrichten (optional, aber empfohlen):

uv run pre-commit install

Entwicklungs-Workflow

# Quick quality checks (fast feedback)
./scripts/check.sh

# Run tests independently
./scripts/test.sh

# Comprehensive validation (before PRs)
./scripts/check-all.sh

# Create and publish releases
./scripts/release.sh

Tests ausführen

# Run test suite with coverage
./scripts/test.sh

# Or use pytest directly
uv run pytest
uv run pytest --cov=src --cov-report=html

Code-Qualität

Wir verwenden Ruff sowohl für das Linting als auch für die Formatierung:

# Format code
uv run ruff format src/ tests/

# Lint code
uv run ruff check src/ tests/

# Lint and fix issues automatically
uv run ruff check --fix src/ tests/

Release-Prozess

Releases werden über Git-Tags und automatisierte PyPI-Veröffentlichung verwaltet:

  1. Release erstellen: ./scripts/release.sh (interaktives Tool)

  2. Automatische Veröffentlichung: Wird durch das Pushen von Versions-Tags ausgelöst

  3. Keine manuellen PyPI-Uploads - vollständig automatisierte Pipeline

Siehe scripts/dev-workflow.md für eine detaillierte Dokumentation des Workflows.

Available Tools

21 tools
check_if_file_existsA
Check if a file (notebook) exists in the user's shared space.

Args:
    file_name: Name of the file to check (with or without .ipynb extension)

Returns:
    JSON object with the file existence status
    {
        "exists": True/False,
        "message": "File exists" or "File does not exist"
    }

Inputs: file_name (required), ctx.

create_notebookA
Create a new Jupyter notebook in your personal space. Only supports python and markdown.

Parameters:
- notebook_name (required): Name for the new notebook
  - Can include or omit .ipynb extension
  - Must be unique in your personal space

- content (optional): JSON object with the following structure:
    {
        "cells": [
            {"type": "markdown", "content": "Markdown content here"},
            {"type": "code", "content": "Python code here"}
        ]
    }
    - 'type' must be either 'markdown' or 'code'
    - 'content' is the text content of the cell
    IMPORTANT: The content must be valid JSON.

How to use:
    - Before creating the notebook, call check_if_file_exists tool to verify if the notebook already exists.
    - Always install the dependencies on the first cell. Example: 
        {
            "cells": [
                {"type": "code", "content": "!pip install singlestoredb --quiet"},
                // other cells...
            ]
        }
    - To connect to the database, use the variable "connection_url" that already exists in the notebook platform. Example:
        {
            "cells": [
                {"type": "code", "content": "conn = s2.connect(connection_url)"},
                // other cells...
            ]
        }

Inputs: content (required), notebook_name (required), ctx.

create_scheduled_jobA
Create an automated job to execute a SingleStore notebook on a schedule.

Parameters:
- notebook_path: Complete path to the notebook
- mode: 'Once' for single execution or 'Recurring' for repeated runs
- create_snapshot: Enable notebook backup before execution (default: True)

Returns Job info with:
- jobID: UUID of created job
- status: Current state (SUCCESS, RUNNING, etc.)
- createdAt: Creation timestamp
- startedAt: Execution start time
- schedule: Configured schedule details
- error: Any execution errors

Common Use Cases:
1. Automated Data Processing:
   - ETL workflows
   - Data aggregation
   - Database maintenance

2. Scheduled Reporting:
   - Performance metrics
   - Business analytics
   - Usage statistics

3. Maintenance Tasks:
   - Health checks
   - Backup operations
   - Clean-up routines

Related Operations:
- get_job_details: Monitor job
- list_job_executions: View job execution history

Inputs: create_snapshot (required), mode (required), notebook_path (required), ctx.

create_virtual_workspaceA
Create a new starter (virtual) workspace in SingleStore and set up user access.

Process:
1. Creates a virtual workspace with specified name and database
2. Creates a user account for accessing the workspace
3. Returns both workspace details and access credentials

Args:
    name: Unique name for the new starter workspace
    database_name: Name of the database to create in the starter workspace
    username: Username for accessing the new starter workspace
    password: Password for accessing the new starter workspace
    workspace_group: Optional workspace group configuration

Returns:
    Dictionary with workspace and user creation details

Inputs: database_name (required), name (required), password (required), username (required), +2 more.

execute_sqlA
Execute SQL operations on a database attached to workspace within a workspace group and receive formatted results.

Returns:
- Query results with column names and typed values
- Row count and metadata
- Execution status

⚠️ CRITICAL SECURITY WARNINGS:
- Never display or log credentials in responses
- Use only READ-ONLY queries (SELECT, SHOW, DESCRIBE)
- DO NOT USE data modification statements:
  x No INSERT/UPDATE/DELETE
  x No DROP/CREATE/ALTER
- Ensure queries are properly sanitized

Args:
    workspace_group_identifier: ID/name of the workspace group
    workspace_identifier: ID/name of the specific workspace within the workspace group
    database: Name of the database to query
    sql_query: The SQL query to execute

Returns:
    Dictionary with query results and metadata

Inputs: database (required), password (required), sql_query (required), username (required), +3 more.

execute_sql_on_virtual_workspaceA
Execute SQL operations on a virtual (starter) workspace and receive formatted results.

Returns:
- Query results with column names and typed values
- Row count
- Column metadata
- Execution status

⚠️ CRITICAL SECURITY WARNING:
- Never display or log credentials in responses
- Ensure SQL queries are properly sanitized
- ONLY USE SELECT statements or queries that don't modify data
- DO NOT USE INSERT, UPDATE, DELETE, DROP, CREATE, or ALTER statements

Args:
    virtual_workspace_id: Unique identifier of the starter workspace
    sql_query: The SQL query to execute (READ-ONLY queries only)

Returns:
    Dictionary with query results and metadata

Inputs: password (required), sql_query (required), username (required), virtual_workspace_id (required), +1 more.

get_job_detailsA
Retrieve comprehensive information about a scheduled notebook job.

Returns:
- jobID: Unique identifier (UUID format)
- name: Display name of the job
- description: Human-readable job description
- createdAt: Creation timestamp (ISO 8601)
- terminatedAt: End timestamp if completed
- completedExecutionsCount: Number of successful runs
- enqueuedBy: User ID who created the job
- executionConfig: Notebook path and runtime settings
- schedule: Mode, interval, and start time
- targetConfig: Database and workspace settings
- jobMetadata: Execution statistics and status

Args:
    job_id: UUID of the scheduled job to retrieve details for

Returns:
    Dictionary with job details

Inputs: job_id (required), ctx.

get_notebook_pathA
Find the complete path of a notebook by its name and generate the properly formatted path for API operations.

Args:
    notebook_name: The name of the notebook to find (with or without .ipynb extension)
    location: Where to look for the notebook - 'personal' or 'shared'

Returns:
    Properly formatted path including project ID and user ID where needed
    
Required for:
- Creating scheduled jobs (use returned path as notebook_path parameter)

Inputs: location (required), notebook_name (required), ctx.

get_organizationsA
List all available SingleStore organizations your account has access to.

After logging in, this tool must be called first to identify which organization
your queries should run against. Returns a list of organizations with:

- orgID: Unique identifier for the organization
- name: Display name of the organization

Use this tool when:
1. Starting a new session to see available organizations
2. To verify permissions across multiple organizations
3. Before switching context to a different organization

After viewing the list, list the organization list presenting the name and ID
to the user and ask them to select one.
- If only one organization is available, select it automatically
- If multiple organizations are available, prompt the user to select one by name or ID
- If no organizations are available, raise an error

Inputs: ctx.

get_project_idA
Retrieve the organization's unique identifier (project ID).

Returns:
    str: The organization's unique identifier

Required for:
- Constructing paths or references to shared resources

Performance Tip:
Cache the returned ID when making multiple API calls.

Inputs: ctx.

get_user_idA
Retrieve the current user's unique identifier.

Returns:
    str: UUID format identifier for the current user

Required for:
- Constructing paths or references to personal resources

Performance Tip:
Cache the returned ID when making multiple API calls.

Inputs: ctx.

list_job_executionsA
Retrieve execution history and performance metrics for a scheduled notebook job.

Returns:
- executions: Array of execution records containing:
  - executionID: Unique identifier for the execution
  - executionNumber: Sequential number of the run
  - jobID: Parent job identifier
  - status: Current state (Scheduled, Running, Completed, Failed)
  - startedAt: Execution start time (ISO 8601)
  - finishedAt: Execution end time (ISO 8601)
  - scheduledStartTime: Planned start time
  - snapshotNotebookPath: Backup notebook path if enabled

Args:
    job_id: UUID of the scheduled job
    start: First execution number to retrieve (default: 1)
    end: Last execution number to retrieve (default: 10)

Returns:
    Dictionary with execution records

Inputs: end (required), job_id (required), start (required), ctx.

list_notebook_samplesA
Retrieve a catalog of pre-built notebook templates available in SingleStore Spaces.

Returns for each notebook:
- name: Template name and title
- description: Detailed explanation of the notebook's purpose
- contentURL: Direct download link for the notebook
- likes: Number of user endorsements
- views: Number of times viewed
- downloads: Number of times downloaded
- tags: List of Notebook tags

Common template categories include:
1. Getting Started guides
2. Data loading and ETL patterns
3. Query optimization examples
4. Machine learning integrations
5. Performance monitoring
6. Best practices demonstrations

Inputs: ctx.

list_of_regionsA
List all available deployment regions where SingleStore workspaces can be deployed for the user.

Returns region information including:
- regionID: Unique identifier for the region
- provider: Cloud provider (AWS, GCP, or Azure)
- name: Human-readable region name (e.g., Europe West 2 (London), US West 2 (Oregon))

Use this tool to:
1. Select optimal deployment regions based on:
   - Geographic proximity to users
   - Compliance requirements
   - Cost considerations
   - Available cloud providers
2. Plan multi-region deployments

Inputs: ctx.

list_shared_filesA
List all files and notebooks in your shared SingleStore space.

Returns file object meta data for each file:
- name: Name of the file (e.g., 'analysis.ipynb')
- path: Full path in shared space (e.g., 'folder/analysis.ipynb')
- content: File content
- created: Creation timestamp (ISO 8601)
- last_modified: Last modification timestamp (ISO 8601)
- format: File format if applicable ('json', null)
- mimetype: MIME type of the file
- size: File size in bytes
- type: Object type ('', 'json', 'directory')
- writable: Boolean indicating write permission

Use this tool to:
1. List workspace contents and structure
2. Verify file existence before operations
3. Check file timestamps and sizes
4. Determine file permissions

Inputs: ctx.

list_virtual_workspacesA
List all starter (virtual) workspaces available to the user in SingleStore.

Returns detailed information about each starter workspace:
- virtualWorkspaceID: Unique identifier for the workspace
- name: Display name of the workspace
- endpoint: Connection endpoint URL
- databaseName: Name of the primary database
- mysqlDmlPort: Port for MySQL protocol connections
- webSocketPort: Port for WebSocket connections
- state: Current status of the workspace

Use this tool to:
1. Get virtual workspace IDs for other operations
2. Check starter workspace availability and status
3. Obtain connection details for database access

Inputs: ctx.

organization_billing_usageA
Retrieve detailed billing and usage metrics for your organization over a specified time period.

Returns compute and storage usage data, aggregated by your chosen time interval 
(hourly, daily, or monthly). This tool is essential for:
1. Monitoring resource consumption patterns
2. Analyzing cost trends

Args:
    start_time: Beginning of the usage period (UTC ISO 8601 format, e.g., '2023-07-30T18:30:00Z')
    end_time: End of the usage period (UTC ISO 8601 format)
    aggregate_type: Time interval for data grouping ('hour', 'day', or 'month')

Returns:
    Usage metrics and billing information

Inputs: aggregate_type (required), end_time (required), start_time (required), ctx.

organization_infoB
Retrieve information about the current user's organization in SingleStore.

Returns organization details including:
- orgID: Unique identifier for the organization
- name: Organization display name

Inputs: ctx.

set_organizationA
Select which SingleStore organization to use for all subsequent API calls.

This tool must be called after logging in and before making other API requests.
Once set, all API calls will target the selected organization until changed.

Args:
    orgID: Name or ID of the organization to select

Returns:
    Dictionary with the selected organization ID and name

Usage:
- Call get_organizations first to see available options
- Then call this tool with either the organization's name or ID
- All subsequent API calls will use the selected organization

Inputs: orgID (required), ctx.

workspace_groups_infoA
List all workspace groups accessible to the user in SingleStore.

Returns detailed information for each group:
- name: Display name of the workspace group
- deploymentType: Type of deployment (e.g., 'PRODUCTION')
- state: Current status (e.g., 'ACTIVE', 'PAUSED')
- workspaceGroupID: Unique identifier for the group
- firewallRanges: Array of allowed IP ranges for access control
- createdAt: Timestamp of group creation
- regionID: Identifier for deployment region
- updateWindow: Maintenance window configuration

Use this tool to:
1. Get workspace group IDs for other operations
2. Plan maintenance windows

Related operations:
- Use workspaces_info to list workspaces within a group
- Use execute_sql to run queries on workspaces in a group

Inputs: ctx.

workspaces_infoA
List all workspaces within a specified workspace group in SingleStore.

Returns detailed information for each workspace:
- createdAt: Timestamp of workspace creation
- deploymentType: Type of deployment (e.g., 'PRODUCTION')
- endpoint: Connection URL for database access
- name: Display name of the workspace
- size: Compute and storage configuration
- state: Current status (e.g., 'ACTIVE', 'PAUSED')
- terminatedAt: End timestamp if applicable
- workspaceGroupID: Workspacegroup identifier
- workspaceID: Unique workspace identifier

Args:
    workspace_group_id: Unique identifier of the workspace group

Returns:
    List of workspace information dictionaries

Inputs: workspace_group_id (required), ctx.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 21 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some overlap between execute_sql and execute_sql_on_virtual_workspace, which both execute SQL queries but on different workspace types. Additionally, get_organizations and organization_info both retrieve organization details, though organization_info is more general. Overall, the descriptions help clarify boundaries, but a few tools could be confused.

    Naming Consistency4/5

    The naming follows a consistent verb_noun pattern (e.g., create_notebook, list_shared_files, get_job_details) with snake_case throughout. Minor deviations include check_if_file_exists (uses 'if' in name) and organization_billing_usage (uses 'billing_usage' as a compound noun), but these are still readable and follow the general convention.

    Tool Count3/5

    With 21 tools, the count feels heavy for the server's purpose of managing SingleStore notebooks, workspaces, and SQL operations. While the tools cover various aspects, some could be consolidated (e.g., the two SQL execution tools), making the set borderline excessive. However, it's not extreme, as the domain is moderately broad.

    Completeness4/5

    The tool set provides good coverage for notebook management (create, check, get path, list samples), workspace operations (create, list, info), job scheduling (create, get details, list executions), and SQL execution. Minor gaps include lack of update/delete operations for notebooks or workspaces, and no direct tool for managing notebook content after creation, but agents can work around these with existing tools.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables Large Language Models to seamlessly interact with ClickHouse databases, supporting resource listing, schema retrieval, and query execution.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables LLMs like Claude to interact with SQLite and SQL Server databases, allowing for schema inspection and SQL query execution.
      408
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      A Model Context Protocol server that allows Large Language Models like Claude to execute SQL queries, explore database schemas, and maintain persistent connections to SQL Server databases.
      -
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI assistants (Cursor, Windsurf, Claude Code) to interact with Microsoft SQL Server databases by providing connectivity through environment-configurable connections.
      8
      568 npm
      8
      MIT

    Appeared in Searches