quickdbd-cli 0.2.3__tar.gz → 0.3.0__tar.gz

{quickdbd_cli-0.2.3 → quickdbd_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: quickdbd-cli
-Version: 0.2.3
+Version: 0.3.0
 Summary: Compile QuickDBD-syntax schema files into interactive HTML ER diagrams, with no table limit.
 Project-URL: Homepage, https://github.com/MarkPhamm/quickdbd-cli
 Author: Minh (Mark) Pham
@@ -9,7 +9,7 @@ License-File: LICENSE
 License-File: NOTICE
 License-File: src/quickdbd_cli/assets/Inter-LICENSE.txt
 License-File: src/quickdbd_cli/assets/elk-LICENSE.md
-Keywords: database,diagram,erd,quickdbd,schema
+Keywords: database,dbml,diagram,erd,mcp,quickdbd,schema
 Classifier: Environment :: Console
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Database
@@ -19,6 +19,7 @@ Requires-Dist: mini-racer>=0.14
 Requires-Dist: resvg-py>=0.5
 Provides-Extra: dev
 Requires-Dist: fonttools>=4.50; extra == 'dev'
+Requires-Dist: mcp<3,>=2.3; extra == 'dev'
 Requires-Dist: pytest>=8; extra == 'dev'
 Requires-Dist: ruff>=0.6; extra == 'dev'
 Provides-Extra: docs
@@ -65,7 +66,8 @@ qdbd is not affiliated with QuickDBD or dbdiagram.io. It reads the same text syn
 - **dbt import**: `qdbd import dbt` reads `manifest.json`. Primary keys come from `unique` + `not_null` tests or constraints, relationships from `relationships` tests, and `--infer-fks` fills the gaps from column names.
 - **Readable at 200+ tables**: automatic layout, search, dbt-style selectors (`+orders+1`, `group:marts`, `tag:fact`), shaded regions per file, collapsed views and a minimap.
 - **Review changes in pull requests**: `qdbd diff` reports what a branch changed, the GitHub Action posts it as a PR comment, and `--diff-base` colours the changes in the diagram.
-- **VS Code extension**: highlighting, errors as you type, outline, F12 across files, and the diagram beside the editor, following your cursor. Export, share, compare with git and dbt import from the Command Palette, with no terminal: it installs the CLI itself. Get it from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=MarkPhamm.quickdbd) or, for Cursor, Windsurf and VSCodium, [Open VSX](https://open-vsx.org/extension/MarkPhamm/quickdbd) ([docs](https://qdbd.dev/vscode/)).
+- **VS Code extension**: highlighting, errors as you type, outline, F12 across files, and the diagram beside the editor, following your cursor, or in your browser on localhost. Export, share, compare with git, convert to and from DBML, and dbt import from the sidebar or the Command Palette, with no terminal: it installs the CLI itself. Get it from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=MarkPhamm.quickdbd) or, for Cursor, Windsurf and VSCodium, [Open VSX](https://open-vsx.org/extension/MarkPhamm/quickdbd) ([docs](https://qdbd.dev/vscode/)).
+- **AI agents**: `qdbd mcp` gives Claude, Copilot and Cursor your schema as tools: tables and columns, join paths as SQL (composite keys included), checks for their edits and diffs against `main` ([docs](https://qdbd.dev/mcp/)).
 - **One schema, many outputs**: an HTML page, PNG, SVG, editable draw.io, or a shareable link. Installs with pip: no Node, Graphviz or browser needed.
 
 ## Demo gallery
@@ -178,7 +180,8 @@ hand-written / pasted ─────────┘           │
                                            ├──▶ qdbd serve   live editor, drag to arrange           ──▶ schema.layout.json
                                            ├──▶ qdbd build   interactive HTML                       ──▶ GitHub Pages, artifacts
                                            ├──▶ qdbd diff    what changed vs main                   ──▶ PR comment
-                                           └──▶ qdbd export  PNG · SVG · draw.io                    ──▶ docs, slides, wikis
+                                           ├──▶ qdbd export  PNG · SVG · draw.io                    ──▶ docs, slides, wikis
+                                           └──▶ qdbd mcp     schema tools for AI agents             ──▶ Claude, Copilot, Cursor
 ```
 
 - **The parser** follows QuickDBD's own parser step by step, so the same text gives the same tables and the same errors.
@@ -230,7 +233,7 @@ No. qdbd only borrows the text syntax.
 No. It reads `.txt` / `.dbml` schema files or a dbt `manifest.json`. Nothing connects to a warehouse.
 
 **Does my schema leave my machine?**
-Only if you run `qdbd share`, which uploads the page to a GitHub gist in your account (secret by default). `qdbd serve` loads its code editor from a CDN; the built pages load nothing.
+Only if you run `qdbd share`, which uploads the page to a GitHub gist in your account (secret by default), or connect an AI agent through `qdbd mcp`, whose answers go to your AI provider. `qdbd serve` loads its code editor from a CDN; the built pages load nothing.
 
 **How big can a diagram get?**
 The demos go up to 200 tables. Search, selectors, regions and collapsed views keep large diagrams workable; `--select` builds a page with just the part you need.
@@ -244,6 +247,7 @@ You edit the text; the diagram is generated from it. Table positions are the one
 - [Schema Syntax](https://qdbd.dev/syntax/), [many files](https://qdbd.dev/files/), [table positions](https://qdbd.dev/layout/), [tags and colours](https://qdbd.dev/tags/)
 - [Reading the Diagram](https://qdbd.dev/reading-the-diagram/), [selectors](https://qdbd.dev/selectors/), [exports](https://qdbd.dev/exports/), [sharing a link](https://qdbd.dev/sharing/)
 - [dbt Projects](https://qdbd.dev/dbt/), with a [jaffle_shop walkthrough](https://qdbd.dev/example/)
+- [AI Agents (MCP)](https://qdbd.dev/mcp/): `qdbd mcp` for Claude, Copilot and Cursor
 - [Schema Diffs](https://qdbd.dev/diffs/), the [GitHub Action](https://qdbd.dev/github-action/) and the [CLI reference](https://qdbd.dev/cli/)
 - [Development](https://qdbd.dev/development/): working on qdbd itself, releasing, and adding a demo
 

{quickdbd_cli-0.2.3 → quickdbd_cli-0.3.0}/README.md

@@ -37,7 +37,8 @@ qdbd is not affiliated with QuickDBD or dbdiagram.io. It reads the same text syn
 - **dbt import**: `qdbd import dbt` reads `manifest.json`. Primary keys come from `unique` + `not_null` tests or constraints, relationships from `relationships` tests, and `--infer-fks` fills the gaps from column names.
 - **Readable at 200+ tables**: automatic layout, search, dbt-style selectors (`+orders+1`, `group:marts`, `tag:fact`), shaded regions per file, collapsed views and a minimap.
 - **Review changes in pull requests**: `qdbd diff` reports what a branch changed, the GitHub Action posts it as a PR comment, and `--diff-base` colours the changes in the diagram.
-- **VS Code extension**: highlighting, errors as you type, outline, F12 across files, and the diagram beside the editor, following your cursor. Export, share, compare with git and dbt import from the Command Palette, with no terminal: it installs the CLI itself. Get it from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=MarkPhamm.quickdbd) or, for Cursor, Windsurf and VSCodium, [Open VSX](https://open-vsx.org/extension/MarkPhamm/quickdbd) ([docs](https://qdbd.dev/vscode/)).
+- **VS Code extension**: highlighting, errors as you type, outline, F12 across files, and the diagram beside the editor, following your cursor, or in your browser on localhost. Export, share, compare with git, convert to and from DBML, and dbt import from the sidebar or the Command Palette, with no terminal: it installs the CLI itself. Get it from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=MarkPhamm.quickdbd) or, for Cursor, Windsurf and VSCodium, [Open VSX](https://open-vsx.org/extension/MarkPhamm/quickdbd) ([docs](https://qdbd.dev/vscode/)).
+- **AI agents**: `qdbd mcp` gives Claude, Copilot and Cursor your schema as tools: tables and columns, join paths as SQL (composite keys included), checks for their edits and diffs against `main` ([docs](https://qdbd.dev/mcp/)).
 - **One schema, many outputs**: an HTML page, PNG, SVG, editable draw.io, or a shareable link. Installs with pip: no Node, Graphviz or browser needed.
 
 ## Demo gallery
@@ -150,7 +151,8 @@ hand-written / pasted ─────────┘           │
                                            ├──▶ qdbd serve   live editor, drag to arrange           ──▶ schema.layout.json
                                            ├──▶ qdbd build   interactive HTML                       ──▶ GitHub Pages, artifacts
                                            ├──▶ qdbd diff    what changed vs main                   ──▶ PR comment
-                                           └──▶ qdbd export  PNG · SVG · draw.io                    ──▶ docs, slides, wikis
+                                           ├──▶ qdbd export  PNG · SVG · draw.io                    ──▶ docs, slides, wikis
+                                           └──▶ qdbd mcp     schema tools for AI agents             ──▶ Claude, Copilot, Cursor
 ```
 
 - **The parser** follows QuickDBD's own parser step by step, so the same text gives the same tables and the same errors.
@@ -202,7 +204,7 @@ No. qdbd only borrows the text syntax.
 No. It reads `.txt` / `.dbml` schema files or a dbt `manifest.json`. Nothing connects to a warehouse.
 
 **Does my schema leave my machine?**
-Only if you run `qdbd share`, which uploads the page to a GitHub gist in your account (secret by default). `qdbd serve` loads its code editor from a CDN; the built pages load nothing.
+Only if you run `qdbd share`, which uploads the page to a GitHub gist in your account (secret by default), or connect an AI agent through `qdbd mcp`, whose answers go to your AI provider. `qdbd serve` loads its code editor from a CDN; the built pages load nothing.
 
 **How big can a diagram get?**
 The demos go up to 200 tables. Search, selectors, regions and collapsed views keep large diagrams workable; `--select` builds a page with just the part you need.
@@ -216,6 +218,7 @@ You edit the text; the diagram is generated from it. Table positions are the one
 - [Schema Syntax](https://qdbd.dev/syntax/), [many files](https://qdbd.dev/files/), [table positions](https://qdbd.dev/layout/), [tags and colours](https://qdbd.dev/tags/)
 - [Reading the Diagram](https://qdbd.dev/reading-the-diagram/), [selectors](https://qdbd.dev/selectors/), [exports](https://qdbd.dev/exports/), [sharing a link](https://qdbd.dev/sharing/)
 - [dbt Projects](https://qdbd.dev/dbt/), with a [jaffle_shop walkthrough](https://qdbd.dev/example/)
+- [AI Agents (MCP)](https://qdbd.dev/mcp/): `qdbd mcp` for Claude, Copilot and Cursor
 - [Schema Diffs](https://qdbd.dev/diffs/), the [GitHub Action](https://qdbd.dev/github-action/) and the [CLI reference](https://qdbd.dev/cli/)
 - [Development](https://qdbd.dev/development/): working on qdbd itself, releasing, and adding a demo
 

{quickdbd_cli-0.2.3 → quickdbd_cli-0.3.0}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "quickdbd-cli"
-version = "0.2.3"
+version = "0.3.0"
 description = "Compile QuickDBD-syntax schema files into interactive HTML ER diagrams, with no table limit."
 readme = "README.md"
 license = "Apache-2.0"
 license-files = ["LICENSE", "NOTICE", "src/quickdbd_cli/assets/*LICENSE*"]
 requires-python = ">=3.11"
 authors = [{ name = "Minh (Mark) Pham" }]
-keywords = ["erd", "database", "diagram", "quickdbd", "schema"]
+keywords = ["erd", "database", "diagram", "quickdbd", "schema", "dbml", "mcp"]
 classifiers = [
   "Programming Language :: Python :: 3",
   "Environment :: Console",
@@ -24,7 +24,7 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-dev = ["pytest>=8", "ruff>=0.6", "fonttools>=4.50"]
+dev = ["pytest>=8", "ruff>=0.6", "fonttools>=4.50", "mcp>=2.3,<3"]  # mcp: interop tests only, not a runtime dep
 docs = ["mkdocs>=1.6,<2", "mkdocs-material>=9.5,<10"]
 
 [project.scripts]

quickdbd_cli-0.3.0/src/quickdbd_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.3.0"