SkillFoxx

YDB MCP connection demo built on a notes app

Simple CLI Notes Application with YDB

An official YDB example: docker compose brings up a YDB database and the ydb-mcp server, and Cursor runs SQL through them right from chat

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP serverOfficial

Extended access

Why this level

  • The MCP server runs arbitrary SQL, including changes to YDB's schema and data
  • The demo configuration has no authorization protecting MCP access
All reasons and checks
Russian stack

ydb-platform/ydb-mcp-demo-notesAuthor:YDB

Install

Services

Manual install

docker-compose up -d ydb ydb-mcp

The first run builds the ydb-mcp image slower; later runs use the cached image.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The MCP server runs arbitrary SQL, including changes to YDB's schema and data
  • The demo configuration has no authorization protecting MCP access

This is third-party code. Review the repository files before installing.

What it does

The project shows how to connect an agent to a YDB database through MCP. Docker Compose brings up three services: a local YDB server, the ydb-mcp server built from the official pip package, and a simple Python CLI notes app as a sample database. A ready .cursor/mcp.json file launches ydb-mcp via docker compose run and lets Cursor run SQL queries, inspect and change YDB's schema and data right from the chat. The notes app itself is only there for illustration: creating, listing, viewing and deleting notes through YDB.

Who it is for. For developers who want to quickly try MCP access to YDB from Cursor on a local database.

Good fit when

  • You want a quick local YDB stand with MCP access for Cursor
  • You want an example docker-compose setup wiring YDB and ydb-mcp together
  • You want a toy example of how an agent sees YDB's schema and data

Not a fit when

  • You need to connect MCP to an existing production YDB: this config targets a local container
  • You want a ready notes package: this is a teaching example, not a product

Example request

Connect to my local YDB database and show which tables exist

MCP

Transport
stdio
Authentication
not required

Environment variables

YDB_ENDPOINT required
The YDB server address, e.g. grpc://localhost:2136.
YDB_DATABASE required
The YDB database path, e.g. /local.

Limitations

This is a demonstration project wrapping the official ydb-mcp package, not a separate product: the actual MCP server is the ydb-mcp pip package, and the repository just wires it into docker-compose with a toy notes app. Requires Docker and Docker Compose. There have been no pushes or updates for over a year. The README is in English.

How to disable. Stop the containers with docker-compose down and remove the ydb block from .cursor/mcp.json.

FAQ

What actually runs the SQL queries?

The official ydb-mcp pip package, built in Dockerfile.ydb-mcp; this repository just wires it to a local YDB and Cursor via docker-compose.

Do I need Python locally?

No, with Docker Compose you don't need to install Python, every service runs in containers.

Discussion

No questions or reviews yet.

All YDB tools
Official

YDB's own official MCP server from the database's developers: parameterized SQL queries, execution plans, directory browsing, and a base for custom servers

MCP serverBroad access29
Russian stack

A skill and MCP server for operating Docker-based local-ydb deployments: nodes, schema, dump and restore, locally or over SSH

PluginExtended access5
Official

An official long-term memory MCP server for agents on YDB Serverless: mem0 extracts facts, YDB stores the vectors

MCP serverExtended access2
Official

A single-binary MCP server for MySQL, MariaDB, PostgreSQL and SQLite: read-only by default, with optional PII redaction

MCP serverBroad access33

A Rust terminal database client with MCP and a JSON CLI: agents read schemas and run queries within profile permissions.

CLIExtended access67

One MCP server for SQLite, SQL Server, PostgreSQL and MySQL: read and change data, edit schemas and export to CSV and JSON

MCP serverBroad access391

README in short

The main English README describes the YDB CLI notes app and running it via Docker Compose. A separate README-MCP.md and QUICKSTART-MCP.md explain the ydb-mcp service configuration with host networking, the YDB_ENDPOINT and YDB_DATABASE variables, and connecting it in Cursor through .cursor/mcp.json.

README badge

Report a problem