Servidor MCP de Timeplus

Un servidor MCP para Timeplus.

Características

Indicaciones

• generate_sql para brindarle a LLM más conocimientos sobre cómo consultar Timeplus a través de SQL

Herramientas

• run_sql

  • Ejecute consultas SQL en su clúster Timeplus.

  • Entrada: sql (cadena): la consulta SQL a ejecutar.

  • De forma predeterminada, todas las consultas de Timeplus se ejecutan con readonly = 1 para garantizar su seguridad. Si desea ejecutar consultas DDL o DML, puede establecer la variable de entorno TIMEPLUS_READ_ONLY en false .

• list_databases

  • Enumere todas las bases de datos en su clúster Timeplus.

• list_tables

  • Enumerar todas las tablas de una base de datos.

  • Entrada: database (cadena): el nombre de la base de datos.

• list_kafka_topics

  • Enumerar todos los temas en un clúster de Kafka

• explore_kafka_topic

  • Mostrar algunos mensajes en el tema de Kafka

  • Entrada: topic (cadena): el nombre del tema. message_count (int): la cantidad de mensajes a mostrar, el valor predeterminado es 1.

• create_kafka_stream

  • Configurar un ETL de transmisión en Timeplus para guardar los mensajes de Kafka localmente

  • Entrada: topic (cadena): el nombre del tema.

• connect_to_apache_iceberg

  • Conéctese a una base de datos basada en Apache Iceberg. Actualmente, esto solo está disponible a través de Timeplus Enterprise y está previsto que esté disponible próximamente para Timeplus Proton.

  • Entrada: iceberg_db (cadena): el nombre de la base de datos Iceberg. aws_account_id (int): el ID de la cuenta de AWS (12 dígitos). s3_bucket (cadena): el nombre del bucket de S3. aws_region (cadena): la región de AWS, el valor predeterminado es "us-west-2". is_s3_table_bucket (bool): si el bucket de S3 es un bucket de tabla de S3, el valor predeterminado es Falso.

Related MCP server: qb-time-mcp-server

Configuración

Primero, asegúrate de tener instalado el ejecutable uv . De lo contrario, puedes instalarlo siguiendo las instrucciones aquí .

1. Abra el archivo de configuración de Claude Desktop ubicado en:

   • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • En Windows: %APPDATA%/Claude/claude_desktop_config.json

2. Añade lo siguiente:

Actualice las variables de entorno para que apunten a su propio servicio Timeplus.

3. Reinicie Claude Desktop para aplicar los cambios.

También puedes probar este servidor MCP con otros clientes MCP, como 5ire .

Desarrollo

1. En el directorio test-services ejecute docker compose up -d para iniciar un servidor Timeplus Proton. También puede descargarlo mediante curl https://install.timeplus.com/oss | sh y luego iniciarlo con ./proton server .

2. Agregue las siguientes variables a un archivo .env en la raíz del repositorio.

3. Ejecute uv sync para instalar las dependencias. Luego, ejecute source .venv/bin/activate .

4. Para facilitar las pruebas, puede ejecutar mcp dev mcp_timeplus/mcp_server.py para iniciar el servidor MCP. Haga clic en el botón "Conectar" para conectar la interfaz de usuario con el servidor MCP y, a continuación, vaya a la pestaña "Herramientas" para ejecutar las herramientas disponibles.

5. Para crear la imagen de Docker, ejecute docker build -t mcp_timeplus . .

Variables de entorno

Las siguientes variables de entorno se utilizan para configurar la conexión Timeplus:

Variables requeridas

• TIMEPLUS_HOST : El nombre de host de su servidor Timeplus

• TIMEPLUS_USER : El nombre de usuario para la autenticación

• TIMEPLUS_PASSWORD : La contraseña para la autenticación

Variables opcionales

• TIMEPLUS_PORT : El número de puerto de su servidor Timeplus

  • Predeterminado: 8443 si HTTPS está habilitado, 8123 si está deshabilitado

  • Generalmente no es necesario configurarlo a menos que se utilice un puerto no estándar

• TIMEPLUS_SECURE : Habilitar/deshabilitar la conexión HTTPS

  • Predeterminado: "false"

  • Establezca en "true" para conexiones seguras

• TIMEPLUS_VERIFY : Habilitar/deshabilitar la verificación del certificado SSL

  • Valor predeterminado: "true"

  • Establezca en "false" para deshabilitar la verificación del certificado (no recomendado para producción)

• TIMEPLUS_CONNECT_TIMEOUT : Tiempo de espera de conexión en segundos

  • Valor predeterminado: "30"

  • Aumente este valor si experimenta tiempos de espera de conexión

• TIMEPLUS_SEND_RECEIVE_TIMEOUT : Tiempo de espera de envío/recepción en segundos

  • Valor predeterminado: "300"

  • Aumente este valor para consultas de larga duración

• TIMEPLUS_DATABASE : Base de datos predeterminada a utilizar

  • Predeterminado: Ninguno (usa el valor predeterminado del servidor)

  • Configure esto para conectarse automáticamente a una base de datos específica

• TIMEPLUS_READ_ONLY : Habilitar/deshabilitar el modo de solo lectura

  • Valor predeterminado: "true"

  • Establezca en "false" para habilitar DDL/DML

• TIMEPLUS_KAFKA_CONFIG : Cadena JSON para la configuración de Kafka. Consulte la configuración de librdkafka o utilice el ejemplo anterior como referencia.