Skip to main content
Glama
Sign In
deenesjakoruzh

YDB MCP

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

YDB MCP

Model Context Protocol-Server für YDB . Ermöglicht die Arbeit mit YDB-Datenbanken von jedem LLM aus, das MCP unterstützt. Diese Integration ermöglicht KI-gestützte Datenbankoperationen und natürlichsprachliche Interaktionen mit Ihren YDB-Instanzen.

Verwendung

Über uvx

uvx , ein Allias für uv run tool , ermöglicht die Ausführung verschiedener Python-Anwendungen, ohne diese explizit installieren zu müssen. Nachfolgend finden Sie Beispiele zur Konfiguration von YDB MCP mit uvx .

Beispiel: Verwenden der anonymen Authentifizierung
{ "mcpServers": { "ydb": { "command": "uvx", "args": [ "ydb-mcp", "--ydb-endpoint", "grpc://localhost:2136/local" ] } } }
Beispiel: Verwenden der Login/Passwort-Authentifizierung

Um die Login/Passwort-Authentifizierung zu verwenden, geben Sie die Argumente --ydb-auth-mode , --ydb-login und --ydb-password an:

{ "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>" ] } } }

Über pipx

Mit pipx können Sie verschiedene Anwendungen von PyPI ausführen, ohne jede einzelne explizit installieren zu müssen. Es muss jedoch zuerst installiert werden. Nachfolgend finden Sie Beispiele zur Konfiguration von YDB MCP mit pipx .

Beispiel: Verwenden der anonymen Authentifizierung
{ "mcpServers": { "ydb": { "command": "pipx", "args": [ "run", "ydb-mcp", "--ydb-endpoint", "grpc://localhost:2136/local" ] } } }
Beispiel: Verwenden der Login/Passwort-Authentifizierung

Um die Login/Passwort-Authentifizierung zu verwenden, geben Sie die Argumente --ydb-auth-mode , --ydb-login und --ydb-password an:

{ "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>" ] } } }

Über Pip

YDB MCP kann mit pip , dem Paketinstallationsprogramm von Python , installiert werden. Das Paket ist auf PyPI verfügbar und enthält alle notwendigen Abhängigkeiten.

pip install ydb-mcp

Um mit YDB MCP zu beginnen, müssen Sie Ihren MCP-Client für die Kommunikation mit der YDB-Instanz konfigurieren. Nachfolgend finden Sie Beispielkonfigurationsdateien, die Sie entsprechend Ihrer Konfiguration anpassen und anschließend in die Einstellungen des MCP-Clients einfügen können. Der Pfad zum Python-Interpreter muss möglicherweise auch an die richtige virtuelle Umgebung angepasst werden, in der das ydb-mcp -Paket installiert ist.

Beispiel: Verwenden der anonymen Authentifizierung
{ "mcpServers": { "ydb": { "command": "python3", "args": [ "-m", "ydb_mcp", "--ydb-endpoint", "grpc://localhost:2136/local" ] } } }
Beispiel: Verwenden der Login/Passwort-Authentifizierung

Um die Login/Passwort-Authentifizierung zu verwenden, geben Sie die Argumente --ydb-auth-mode , --ydb-login und --ydb-password an:

{ "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>" ] } } }

Verfügbare Tools

YDB MCP bietet die folgenden Tools für die Interaktion mit YDB-Datenbanken:

  • ydb_query : Führen Sie eine SQL-Abfrage für eine YDB-Datenbank aus
    • Parameter:
      • sql : Auszuführende SQL-Abfragezeichenfolge
  • ydb_query_with_params : Führen Sie eine parametrisierte SQL-Abfrage mit JSON-Parametern aus
    • Parameter:
      • sql : SQL-Abfragezeichenfolge mit Parameterplatzhaltern
      • params : JSON-Zeichenfolge mit Parameterwerten
  • ydb_list_directory : Verzeichnisinhalte in YDB auflisten
    • Parameter:
      • path : YDB-Verzeichnispfad zur Liste
  • ydb_describe_path : Erhalten Sie detaillierte Informationen zu einem YDB-Pfad (Tabelle, Verzeichnis usw.).
    • Parameter:
      • path : Zu beschreibender YDB-Pfad
  • ydb_status : Aktuellen Status der YDB-Verbindung abrufen

Entwicklung

Das Projekt verwendet Make als primäres Entwicklungstool und bietet eine konsistente Schnittstelle für allgemeine Entwicklungsaufgaben.

Verfügbare Make-Befehle

Das Projekt enthält ein umfangreiches Makefile mit verschiedenen Befehlen für Entwicklungsaufgaben. Jeder Befehl ist darauf ausgelegt, den Entwicklungsablauf zu optimieren und die Codequalität sicherzustellen:

  • make all : Clean, Lint und Test nacheinander ausführen (Standardziel)
  • make clean : Entfernt alle Build-Artefakte und temporären Dateien
  • make test : Führen Sie alle Tests mit pytest aus
    • Kann mit Umgebungsvariablen konfiguriert werden:
      • LOG_LEVEL (Standard: WARNUNG) – Steuert die Ausführlichkeit der Testausgabe (DEBUG, INFO, WARNUNG, FEHLER)
  • make unit-tests : Führen Sie nur Unit-Tests mit ausführlicher Ausgabe aus
    • Kann mit Umgebungsvariablen konfiguriert werden:
      • LOG_LEVEL (Standard: WARNUNG) – Steuert die Ausführlichkeit der Testausgabe (DEBUG, INFO, WARNUNG, FEHLER)
  • make integration-tests : Führen Sie nur Integrationstests mit ausführlicher Ausgabe aus
    • Kann mit Umgebungsvariablen konfiguriert werden:
      • YDB_ENDPOINT (Standard: grpc://localhost:2136)
      • YDB_DATABASE (Standard: /local)
      • MCP_HOST (Standard: 127.0.0.1)
      • MCP_PORT (Standard: 8989)
      • LOG_LEVEL (Standard: WARNUNG) – Steuert die Ausführlichkeit der Testausgabe (DEBUG, INFO, WARNUNG, FEHLER)
  • make run-server : Starten Sie den YDB MCP-Server
    • Kann mit Umgebungsvariablen konfiguriert werden:
      • YDB_ENDPOINT (Standard: grpc://localhost:2136)
      • YDB_DATABASE (Standard: /local)
    • Zusätzliche Argumente können mit ARGS="your args" übergeben werden.
  • make lint : Alle Lint-Prüfungen ausführen (flake8, mypy, black, isort)
  • make format : Code mit Black und Isort formatieren
  • make install : Installieren Sie das Paket im Entwicklungsmodus
  • make dev : Installieren Sie das Paket im Entwicklungsmodus mit allen Entwicklungsabhängigkeiten

Ausführlichkeitskontrolle testen

Standardmäßig werden Tests mit minimaler Ausgabe (Warnstufe) ausgeführt, um die Ausgabe sauber zu halten. Sie können die Ausführlichkeit der Testausgabe mit der Umgebungsvariable LOG_LEVEL steuern:

# 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

Verfügbare Protokollebenen:

  • DEBUG : Alle Debug-Meldungen anzeigen, nützlich für einen detaillierten Testablauf
  • INFO : Informationsmeldungen und darüber anzeigen
  • WARNING : Nur Warnungen und Fehler anzeigen (Standard)
  • ERROR : Nur Fehlermeldungen anzeigen

You must be authenticated.

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.

Tools

Model Context Protocol-Server für YDB-Datenbanken, der KI-gestützte Datenbankoperationen und Interaktionen in natürlicher Sprache mit YDB-Instanzen von jedem LLM aus ermöglicht, das MCP unterstützt.

  1. Verwendung
    1. Über uvx
    2. Über pipx
    3. Über Pip
  2. Verfügbare Tools
    1. Entwicklung
      1. Verfügbare Make-Befehle
      2. Ausführlichkeitskontrolle testen

    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 Milvus

      zilliztech
      -
      security
      A
      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 -
      122
      Python
      Apache 2.0
      • 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

    New 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