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

YDB用のモデルコンテキストプロトコルサーバー。MCPをサポートするあらゆるLLMからYDBデータベースを操作できます。この統合により、AIを活用したデータベース操作と、YDBインスタンスとの自然言語によるインタラクションが可能になります。

使用法

uvx経由

uvxはuv run toolのエイリアスで、様々な Python アプリケーションを明示的にインストールすることなく実行できます。以下は、 uvxを使用して YDB MCP を設定する方法の例です。

例:匿名認証の使用
{ "mcpServers": { "ydb": { "command": "uvx", "args": [ "ydb-mcp", "--ydb-endpoint", "grpc://localhost:2136/local" ] } } }
例: ログイン/パスワード認証の使用

ログイン/パスワード認証を使用するには、 --ydb-auth-mode 、 --ydb-login 、および--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>" ] } } }

pipx経由

pipx を使うと、PyPI から様々なアプリケーションを個別にインストールすることなく実行できます。ただし、事前に pipxをインストールする必要があります。以下は、 pipxを使って YDB MCP を設定する方法の例です。

例:匿名認証の使用
{ "mcpServers": { "ydb": { "command": "pipx", "args": [ "run", "ydb-mcp", "--ydb-endpoint", "grpc://localhost:2136/local" ] } } }
例: ログイン/パスワード認証の使用

ログイン/パスワード認証を使用するには、 --ydb-auth-mode 、 --ydb-login 、および--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>" ] } } }

pip経由

YDB MCPは、 Pythonのパッケージインストーラーであるpipを使用してインストールできます。このパッケージはPyPIで入手でき、必要な依存関係がすべて含まれています。

pip install ydb-mcp

YDB MCPを使い始めるには、MCPクライアントがYDBインスタンスと通信できるように設定する必要があります。以下に、お使いの環境に合わせてカスタマイズし、MCPクライアントの設定に組み込むことができる設定ファイルの例を示します。Pythonインタープリターへのパスも、 ydb-mcpパッケージがインストールされている適切な仮想環境に調整する必要があるかもしれません。

例:匿名認証の使用
{ "mcpServers": { "ydb": { "command": "python3", "args": [ "-m", "ydb_mcp", "--ydb-endpoint", "grpc://localhost:2136/local" ] } } }
例: ログイン/パスワード認証の使用

ログイン/パスワード認証を使用するには、 --ydb-auth-mode 、 --ydb-login 、および--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>" ] } } }

利用可能なツール

YDB MCP は、YDB データベースと対話するための次のツールを提供します。

  • ydb_query : YDBデータベースに対してSQLクエリを実行する
    • パラメータ:
      • sql : 実行するSQLクエリ文字列
  • ydb_query_with_params : JSONパラメータを使用してパラメータ化されたSQLクエリを実行する
    • パラメータ:
      • sql : パラメータプレースホルダを含むSQLクエリ文字列
      • params : パラメータ値を含むJSON文字列
  • ydb_list_directory : YDB内のディレクトリの内容を一覧表示する
    • パラメータ:
      • path : リストするYDBディレクトリパス
  • ydb_describe_path : YDB パス (テーブル、ディレクトリなど) の詳細情報を取得します。
    • パラメータ:
      • path : 記述するYDBパス
  • ydb_status : YDB接続の現在のステータスを取得する

発達

このプロジェクトでは、主な開発ツールとしてMake を使用し、一般的な開発タスクに一貫したインターフェースを提供します。

利用可能なMakeコマンド

このプロジェクトには、開発タスク用の様々なコマンドを含む包括的なMakefileが含まれています。各コマンドは、開発ワークフローを効率化し、コードの品質を確保するように設計されています。

  • make all : clean、lint、test を順に実行します (デフォルトのターゲット)
  • make clean : すべてのビルド成果物と一時ファイルを削除する
  • make test : pytestを使ってすべてのテストを実行する
    • 環境変数で設定できます:
      • LOG_LEVEL (デフォルト: WARNING) - テスト出力の詳細度を制御します (DEBUG、INFO、WARNING、ERROR)
  • make unit-tests : 詳細な出力でユニットテストのみを実行する
    • 環境変数で設定できます:
      • LOG_LEVEL (デフォルト: WARNING) - テスト出力の詳細度を制御します (DEBUG、INFO、WARNING、ERROR)
  • make integration-tests : 詳細出力付きの統合テストのみを実行する
    • 環境変数で設定できます:
      • YDB_ENDPOINT (デフォルト: grpc://localhost:2136)
      • YDB_DATABASE (デフォルト: /local)
      • MCP_HOST (デフォルト: 127.0.0.1)
      • MCP_PORT (デフォルト: 8989)
      • LOG_LEVEL (デフォルト: WARNING) - テスト出力の詳細度を制御します (DEBUG、INFO、WARNING、ERROR)
  • make run-server : YDB MCPサーバーを起動する
    • 環境変数で設定できます:
      • YDB_ENDPOINT (デフォルト: grpc://localhost:2136)
      • YDB_DATABASE (デフォルト: /local)
    • 追加の引数はARGS="your args"を使って渡すことができます。
  • make lint : すべての linting チェックを実行する (flake8、mypy、black、isort)
  • make format : black と isort を使用してコードをフォーマットする
  • make install : 開発モードでパッケージをインストールする
  • make dev : すべての開発依存関係を含む開発モードでパッケージをインストールする

テストの詳細度制御

デフォルトでは、出力を簡潔に保つため、テストは最小限の出力（WARNINGレベル）で実行されます。テスト出力の詳細度は、 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

利用可能なログレベル:

  • DEBUG : すべてのデバッグメッセージを表示します。詳細なテストフローに役立ちます。
  • INFO : 情報メッセージ以上を表示します
  • WARNING : 警告とエラーのみを表示します（デフォルト）
  • 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

MCP をサポートする任意の LLM からの YDB インスタンスとの AI を活用したデータベース操作と自然言語による対話を可能にする、YDB データベース用のモデル コンテキスト プロトコル サーバー。

  1. 使用法
    1. uvx経由
    2. pipx経由
    3. pip経由
  2. 利用可能なツール
    1. 発達
      1. 利用可能なMakeコマンド
      2. テストの詳細度制御

    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