Skip to main content
Glama
Sign In
enesjakozh

YDB MCP

Official
by ydb-platform
GitHub
Python
Apache 2.0
17
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Mentioned as part of the uvx tool, which is described as 'an alias for uv run tool' from astral.sh for running Python applications without explicitly installing them

  • Used as the primary development tool, providing commands for development tasks

  • Used as a deployment method for running the MCP server without explicit installation

YDB MCP

Servidor de Protocolo de Contexto de Modelo para YDB . Permite trabajar con bases de datos YDB desde cualquier LLM compatible con MCP. Esta integración facilita operaciones de base de datos basadas en IA e interacciones de lenguaje natural con sus instancias YDB.

Uso

Vía uvx

uvx , alias de uv run tool , permite ejecutar diversas aplicaciones de Python sin necesidad de instalarlas explícitamente. A continuación, se muestran ejemplos de cómo configurar YDB MCP con uvx .

Ejemplo: uso de autenticación anónima
{ "mcpServers": { "ydb": { "command": "uvx", "args": [ "ydb-mcp", "--ydb-endpoint", "grpc://localhost:2136/local" ] } } }
Ejemplo: Uso de autenticación de inicio de sesión/contraseña

Para utilizar la autenticación de inicio de sesión/contraseña, especifique los argumentos --ydb-auth-mode , --ydb-login y --ydb-password :

{ "mcpServers": { "ydb": { "command": "uvx", "args": [ "ydb-mcp", "--ydb-endpoint", "grpc://localhost:2136/local", "--ydb-auth-mode", "login-password", "--ydb-login", "<your-username>", "--ydb-password", "<your-password>" ] } } }

Vía pipx

pipx permite ejecutar varias aplicaciones desde PyPI sin necesidad de instalarlas todas. Sin embargo, es necesario instalarlas primero. A continuación, se muestran ejemplos de cómo configurar YDB MCP con pipx .

Ejemplo: uso de autenticación anónima
{ "mcpServers": { "ydb": { "command": "pipx", "args": [ "run", "ydb-mcp", "--ydb-endpoint", "grpc://localhost:2136/local" ] } } }
Ejemplo: Uso de autenticación de inicio de sesión/contraseña

Para utilizar la autenticación de inicio de sesión/contraseña, especifique los argumentos --ydb-auth-mode , --ydb-login y --ydb-password :

{ "mcpServers": { "ydb": { "command": "pipx", "args": [ "run", "ydb-mcp", "--ydb-endpoint", "grpc://localhost:2136/local", "--ydb-auth-mode", "login-password", "--ydb-login", "<your-username>", "--ydb-password", "<your-password>" ] } } }

Vía pip

YDB MCP se puede instalar mediante pip , el instalador de paquetes de Python . El paquete está disponible en PyPI e incluye todas las dependencias necesarias.

pip install ydb-mcp

Para comenzar a usar YDB MCP, deberá configurar su cliente MCP para que se comunique con la instancia de YDB. A continuación, se muestran ejemplos de archivos de configuración que puede personalizar según su configuración y luego agregar a la configuración del cliente MCP. Es posible que también deba ajustar la ruta al intérprete de Python al entorno virtual correcto que tenga instalado el paquete ydb-mcp .

Ejemplo: uso de autenticación anónima
{ "mcpServers": { "ydb": { "command": "python3", "args": [ "-m", "ydb_mcp", "--ydb-endpoint", "grpc://localhost:2136/local" ] } } }
Ejemplo: Uso de autenticación de inicio de sesión/contraseña

Para utilizar la autenticación de inicio de sesión/contraseña, especifique los argumentos --ydb-auth-mode , --ydb-login y --ydb-password :

{ "mcpServers": { "ydb": { "command": "python3", "args": [ "-m", "ydb_mcp", "--ydb-endpoint", "grpc://localhost:2136/local", "--ydb-auth-mode", "login-password", "--ydb-login", "<your-username>", "--ydb-password", "<your-password>" ] } } }

Herramientas disponibles

YDB MCP proporciona las siguientes herramientas para interactuar con las bases de datos YDB:

  • ydb_query : ejecuta una consulta SQL contra una base de datos YDB
    • Parámetros:
      • sql : cadena de consulta SQL para ejecutar
  • ydb_query_with_params : Ejecuta una consulta SQL parametrizada con parámetros JSON
    • Parámetros:
      • sql : cadena de consulta SQL con marcadores de posición de parámetros
      • params : cadena JSON que contiene valores de parámetros
  • ydb_list_directory : Lista el contenido del directorio en YDB
    • Parámetros:
      • path : ruta del directorio YDB a la lista
  • ydb_describe_path : obtiene información detallada sobre una ruta YDB (tabla, directorio, etc.)
    • Parámetros:
      • path : Ruta YDB para describir
  • ydb_status : obtiene el estado actual de la conexión YDB

Desarrollo

El proyecto utiliza Make como su herramienta de desarrollo principal, proporcionando una interfaz consistente para tareas de desarrollo comunes.

Comandos de creación disponibles

El proyecto incluye un Makefile completo con varios comandos para tareas de desarrollo. Cada comando está diseñado para optimizar el flujo de trabajo de desarrollo y garantizar la calidad del código:

  • make all : ejecutar clean, lint y test en secuencia (objetivo predeterminado)
  • make clean : elimina todos los artefactos de compilación y archivos temporales
  • make test : ejecuta todas las pruebas usando pytest
    • Se puede configurar con variables de entorno:
      • LOG_LEVEL (predeterminado: ADVERTENCIA): controla el nivel de detalle de la salida de la prueba (DEBUG, INFO, ADVERTENCIA, ERROR)
  • make unit-tests : ejecutar solo pruebas unitarias con salida detallada
    • Se puede configurar con variables de entorno:
      • LOG_LEVEL (predeterminado: ADVERTENCIA): controla el nivel de detalle de la salida de la prueba (DEBUG, INFO, ADVERTENCIA, ERROR)
  • make integration-tests : ejecutar solo pruebas de integración con salida detallada
    • Se puede configurar con variables de entorno:
      • YDB_ENDPOINT (predeterminado: grpc://localhost:2136)
      • YDB_DATABASE (predeterminado: /local)
      • MCP_HOST (predeterminado: 127.0.0.1)
      • MCP_PORT (predeterminado: 8989)
      • LOG_LEVEL (predeterminado: ADVERTENCIA): controla el nivel de detalle de la salida de la prueba (DEBUG, INFO, ADVERTENCIA, ERROR)
  • make run-server : Inicia el servidor YDB MCP
    • Se puede configurar con variables de entorno:
      • YDB_ENDPOINT (predeterminado: grpc://localhost:2136)
      • YDB_DATABASE (predeterminado: /local)
    • Se pueden pasar argumentos adicionales usando ARGS="your args"
  • make lint : ejecuta todas las comprobaciones de linting (flake8, mypy, black, isort)
  • make format : formatear código usando black e isort
  • make install : instala el paquete en modo de desarrollo
  • make dev : instala el paquete en modo de desarrollo con todas las dependencias de desarrollo

Control de verbosidad de la prueba

De forma predeterminada, las pruebas se ejecutan con un nivel de salida mínimo (WARNING) para mantener la salida limpia. Puede controlar el nivel de detalle de la salida de la prueba mediante la variable de entorno LOG_LEVEL :

# Run all tests with debug output make test LOG_LEVEL=DEBUG # Run integration tests with info output make integration-tests LOG_LEVEL=INFO # Run unit tests with warning output (default) make unit-tests LOG_LEVEL=WARNING

Niveles de registro disponibles:

  • DEBUG : Muestra todos los mensajes de depuración, útil para un flujo de prueba detallado
  • INFO : Mostrar mensajes informativos y superiores
  • WARNING : Mostrar solo advertencias y errores (predeterminado)
  • ERROR : Mostrar solo mensajes de error

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Servidor de protocolo de contexto de modelo para bases de datos YDB que permite operaciones de base de datos impulsadas por IA e interacciones de lenguaje natural con instancias YDB desde cualquier LLM que admita MCP.

  1. Uso
    1. Vía uvx
    2. Vía pipx
    3. Vía pip
  2. Herramientas disponibles
    1. Desarrollo
      1. Comandos de creación disponibles
      2. Control de verbosidad de la prueba

    Related MCP Servers

    • MCP Base

      jsmiff
      -
      security
      F
      license
      -
      quality
      A generic Model Context Protocol framework for building AI-powered applications that provides standardized ways to create MCP servers and clients for integrating LLMs with support for Ollama and Supabase.
      Last updated -
      TypeScript

    • dbt CLI MCP Server

      MammothGrowth
      -
      security
      A
      license
      -
      quality
      A Model Context Protocol (MCP) server that wraps the dbt CLI tool, enabling AI coding agents to interact with dbt projects through standardized MCP tools. Developed by Mammoth Growth.
      Last updated -
      8
      Python
      MIT License
      • Linux
      • Apple

    • MCP Server for Milvusofficial

      zilliztech
      -
      security
      F
      license
      -
      quality
      An integration server implementing the Model Context Protocol that enables LLM applications to interact with Milvus vector database functionality, allowing vector search, collection management, and data operations through natural language.
      Last updated -
      91
      Python
      • Apple

    • MCP MySQL App

      zalab-inc
      -
      security
      A
      license
      -
      quality
      A Model Context Protocol (MCP) server that enables AI assistants to interact with MySQL databases by executing SQL queries and checking database connectivity.
      Last updated -
      TypeScript
      MIT License
      • Apple
      • Linux

    View all related MCP servers

    ID: 5f9hipc1tz