mcp-server-starrocks

by hagsmand
Verified

Integrations

  • The MCP server is built with Python, required as a prerequisite (3.8+), and the server is launched using Python commands

  • Used for database connectivity with the StarRocks database, enabling execution of SELECT queries, table management, and database operations

Servidor MCP de StarRocks

Un servidor de Protocolo de Control de Modelos (MCP) para interactuar con las bases de datos de StarRocks. Este servidor proporciona una interfaz estandarizada para que los modelos de IA consulten y manipulen las bases de datos de StarRocks mediante un conjunto de herramientas definidas.

Descripción general

El servidor MCP de StarRocks permite que los modelos de IA:

  • Ejecutar consultas SELECT en bases de datos de StarRocks
  • Lista de mesas disponibles
  • Describir esquemas de tablas
  • Crear nuevas tablas (cuando no esté en modo de solo lectura)
  • Ejecutar operaciones de escritura como INSERTAR, ACTUALIZAR, ELIMINAR (cuando no esté en modo de solo lectura)

Instalación

Prerrequisitos

  • Python 3.8+
  • Instancia de base de datos de StarRocks
  • SQLAlchemy
  • Biblioteca de Python MCP

Instalar desde la fuente

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

Instalar desde Smithery

npm install @smithery/sdk @modelcontextprotocol/sdk

Uso del inspector MCP

npx @modelcontextprotocol/inspector uv --directorio ~/mcp-server-starrocks ejecutar mcp-server-starrocks

Uso

Iniciando el servidor

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

Argumentos de la línea de comandos:

  • --host : host del servidor StarRocks (obligatorio)
  • --port : puerto del servidor StarRocks (predeterminado: 9030)
  • --user : nombre de usuario de StarRocks (obligatorio)
  • --database : nombre de la base de datos de StarRocks (obligatorio)
  • --password : contraseña de StarRocks (si se requiere)
  • --readonly : Ejecuta el servidor en modo de solo lectura (opcional)

Herramientas disponibles

El servidor proporciona las siguientes herramientas:

Herramientas de solo lectura:

  • read-query : ejecuta una consulta SELECT en la base de datos StarRocks
  • list-tables : enumera todas las tablas en la base de datos StarRocks
  • describe-table : Describe el esquema de una tabla específica

Herramientas de escritura (disponibles cuando no está en modo de solo lectura):

  • write-query : ejecuta una consulta INSERT, UPDATE o DELETE
  • create-table : Crea una nueva tabla en la base de datos de StarRocks

Ejemplos

Tablas de listado

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

Ejecución de una consulta SELECT

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

Describir una tabla

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

Creación de una tabla (cuando no está en modo de solo lectura)

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

Licencia

Licencia MIT

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

-
security - not tested
A
license - permissive license
-
quality - not tested

Este servidor MCP proporciona conexión a Starrocks y le permite explorar este motor de consulta con el mínimo esfuerzo.

  1. Overview
    1. Installation
      1. Prerequisites
      2. Install from source
      3. Install from Smithery
      4. Using MCP Inspector
    2. Usage
      1. Starting the server
      2. Available Tools
    3. Examples
      1. Listing tables
      2. Executing a SELECT query
      3. Describing a table
      4. Creating a table (when not in read-only mode)
    4. License
      1. Contributing
        ID: qjidoviad2