MCP.so
登录

YDB MCP

@ydb-platform

关于 YDB MCP

暂无概览

基本信息

分类

其他

许可证

Apache-2.0

运行时

python

传输方式

stdio

发布者

ydb-platform

配置

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

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

工具

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

FAQ from YDB MCP

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.

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.

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.

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.

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 服务器