From 64b83c7ede76723c107b66398bd3860dccd308da Mon Sep 17 00:00:00 2001 From: pablo Date: Sun, 14 Jun 2026 13:41:43 +0200 Subject: [PATCH] docs: fix quick-start venv setup and MCP command in README Step 2 was calling `uv pip install` without first creating a venv, which fails because uv requires an explicit environment target. Added `uv venv .venv` and pinned installs to that venv with `--python .venv/bin/python`. Step 4 used `uv run --directory /path/to/ai-dev-kit`, but there is no `pyproject.toml` at the repo root, so uv has no project to resolve and cannot guarantee the packages installed in Step 2 are on the path. Replaced with the direct venv interpreter path, which is also what `install.sh` generates when it writes the MCP config automatically. --- databricks-mcp-server/README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/databricks-mcp-server/README.md b/databricks-mcp-server/README.md index f3d7b459..67b4cc18 100644 --- a/databricks-mcp-server/README.md +++ b/databricks-mcp-server/README.md @@ -14,11 +14,11 @@ cd ai-dev-kit ### Step 2: Install the packages ```bash -# Install the core library -uv pip install -e ./databricks-tools-core +# Create a virtual environment +uv venv .venv -# Install the MCP server -uv pip install -e ./databricks-mcp-server +# Install the core library and MCP server into it +uv pip install --python .venv/bin/python -e ./databricks-tools-core -e ./databricks-mcp-server ``` ### Step 3: Configure Databricks authentication @@ -41,8 +41,8 @@ For Cursor, add to your project's `.cursor/mcp.json` (create the file if it does { "mcpServers": { "databricks": { - "command": "uv", - "args": ["run", "--directory", "/path/to/ai-dev-kit", "python", "databricks-mcp-server/run_server.py"], + "command": "/path/to/ai-dev-kit/.venv/bin/python", + "args": ["/path/to/ai-dev-kit/databricks-mcp-server/run_server.py"], "defer_loading": true } }