MCP.so
登录

YDB MCP Server

@ydb-platform

基本信息

分类

其他

许可证

Apache-2.0

传输方式

stdio

作者

ydb-platform

关于 YDB MCP Server

暂无概览

YDB MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "ydb": {
      "command": "uvx",
      "args": [
        "ydb-mcp",
        "--ydb-endpoint",
        "grpc://localhost:2136",
        "--ydb-database",
        "/local"
      ]
    }
  }
}

YDB MCP Server 工具

7

Run a SQL query against a YDB database

Run a parameterized SQL query with JSON parameters

Explain a SQL query (returns the execution plan)

Explain a parameterized SQL query

List directory contents in YDB

Get detailed information about a YDB path (table, directory, etc.)

Get the current status of the YDB connection

概览

What is YDB MCP?

YDB MCP is a Model Context Protocol server for YDB, a distributed SQL database. It allows large language models (LLMs) that support MCP to interact with YDB databases through natural language, enabling AI-powered database operations.

How to use YDB MCP?

Install YDB MCP via uvx, pipx, or pip. Configure your MCP client with the server command and connection arguments (e.g., --ydb-endpoint, --ydb-database). Authentication can be anonymous, login/password, access token, or service account (requires the yandexcloud package for the latter). Examples for each method are provided in the README.

Key features of YDB MCP

  • Run SQL queries against any YDB database
  • Execute parameterized SQL queries with JSON parameters
  • Explain query execution plans
  • List directory contents and describe paths in YDB
  • Check the current status of the YDB connection
  • Supports building custom MCP servers by subclassing YDBMCPServer

Use cases of YDB MCP

  • Let an LLM explore and query a YDB database using natural language
  • Implement read-only, domain-specific database tools for an AI assistant
  • Build custom MCP servers that expose only the queries your application needs
  • Diagnose YDB performance by explaining query plans via AI

常见问题

1

What authentication modes does YDB MCP support?

Anonymous (default), login/password, access token, and service account authentication. Service account requires the `yandexcloud` package installed separately.

2

What tools are included with YDB MCP?

Seven tools: `ydb_query`, `ydb_query_with_params`, `ydb_explain_query`, `ydb_explain_query_with_params`, `ydb_list_directory`, `ydb_describe_path`, and `ydb_status`.

3

Can I restrict which tools the LLM can access?

Yes. When building a custom server by subclassing `YDBMCPServer`, you can set the `generic_tools` class attribute to a subset of `YDBGenericTool` values or an empty set to disable all built-in tools.

4

What are the runtime dependencies for YDB MCP?

YDB MCP is a Python package available on PyPI. It depends on the MCP SDK and YDB client libraries. For service account authentication, the `yandexcloud` package is also required.

5

How do I configure YDB MCP for my client?

Provide the server command (`uvx ydb-mcp`, `pipx run ydb-mcp`, or `python -m ydb_mcp`) and arguments such as `--ydb-endpoint` and `--ydb-database`. Authentication arguments can be added as needed.

评论

其他 分类下的更多 MCP 服务器