Overview
The YDB MCP server implements a Model Context Protocol (MCP) server for YDB databases. It enables interaction with YDB databases from any MCP-enabled LLM, unlocking AI-powered database operations and natural language interfaces. The server exposes a set of tools that translate natural language requests into YDB actions, including executing SQL queries, running parameterized queries with JSON parameters, listing directory contents, describing YDB paths, and checking connection status. It can be run in diverse environments via uvx, pipx, or pip installations, with examples demonstrating how to configure MCP clients to launch ydb-mcp and connect to a YDB endpoint and database. Authentication can be configured through command line options to support login/password, access tokens, or service accounts. The tools are designed to be simple to integrate within MCP client configurations, accepting parameters such as sql, params, path, and endpoint details. The project emphasizes developer tooling via a Makefile with targets for building, testing, and running the server, facilitating development and integration workflows.
Features
ydb_query
Run a SQL query against a YDB database. Parameters: sql (string) - the query to execute.
ydb_query_with_params
Run a parameterized SQL query with JSON parameters. Parameters: sql (string), params (JSON string).
ydb_list_directory
List contents of a YDB directory. Parameters: path (string).
ydb_describe_path
Describe a YDB path (table, directory, etc.). Parameters: path (string).
ydb_status
Get the current status of the YDB connection. Parameters: none.
Who Is This For?
- LLMs:Enable MCP-enabled LLMs to perform YDB queries and directory/path operations.
