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
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
:
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
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
:
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.
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
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
:
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
- Parámetros:
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ámetrosparams
: cadena JSON que contiene valores de parámetros
- Parámetros:
ydb_list_directory
: Lista el contenido del directorio en YDB- Parámetros:
path
: ruta del directorio YDB a la lista
- Parámetros:
ydb_describe_path
: obtiene información detallada sobre una ruta YDB (tabla, directorio, etc.)- Parámetros:
path
: Ruta YDB para describir
- Parámetros:
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 temporalesmake 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)
- Se puede configurar con variables de entorno:
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)
- Se puede configurar con variables de entorno:
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)
- Se puede configurar con variables de entorno:
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"
- Se puede configurar con variables de entorno:
make lint
: ejecuta todas las comprobaciones de linting (flake8, mypy, black, isort)make format
: formatear código usando black e isortmake install
: instala el paquete en modo de desarrollomake 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
:
Niveles de registro disponibles:
DEBUG
: Muestra todos los mensajes de depuración, útil para un flujo de prueba detalladoINFO
: Mostrar mensajes informativos y superioresWARNING
: Mostrar solo advertencias y errores (predeterminado)ERROR
: Mostrar solo mensajes de error
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.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables SQL query execution, database management, and business intelligence capabilities through MySQL connections.Last updated -JavaScript
- AsecurityAlicenseAqualityA 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 -5922MIT License
- AsecurityFlicenseAqualityA 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 -7JavaScript
- AsecurityAlicenseAqualityA 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 -146JavaScriptMIT License