Skip to main content
Glama

YDB MCP

Official
by ydb-platform
Apache 2.0
21
  • Linux
  • Apple

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
Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

    • -
      security
      F
      license
      -
      quality
      A Model Context Protocol server that enables SQL query execution, database management, and business intelligence capabilities through MySQL connections.
      Last updated -
      JavaScript
    • A
      security
      A
      license
      A
      quality
      A Model Context Protocol server that enables AI models to interact with MySQL databases, providing tools for querying, executing statements, listing tables, and describing table structures.
      Last updated -
      5
      922
      MIT License
    • A
      security
      F
      license
      A
      quality
      A Model Context Protocol server that enables AI models to interact with MySQL databases through a standardized interface, providing tools for querying, executing commands, and managing database schemas.
      Last updated -
      7
      JavaScript
    • A
      security
      A
      license
      A
      quality
      A Model Context Protocol server that enables AI models to interact with both MySQL and MongoDB databases through a standardized interface, supporting comprehensive database operations including queries, schema management, and CRUD operations.
      Last updated -
      14
      6
      JavaScript
      MIT License

    View all related MCP servers

    MCP directory API

    We provide all the information about MCP servers via our MCP API.

    curl -X GET 'https://glama.ai/api/mcp/v1/servers/ydb-platform/ydb-mcp'

    If you have feedback or need assistance with the MCP directory API, please join our Discord server