lkr-dev-cli 0.0.35__tar.gz → 0.0.36__tar.gz

{lkr_dev_cli-0.0.35 → lkr_dev_cli-0.0.36}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lkr-dev-cli
-Version: 0.0.35
+Version: 0.0.36
 Summary: lkr: a command line interface for looker
 Author: bwebs
 License-Expression: MIT
@@ -109,9 +109,9 @@ Go to the Looker API Explorer for Register OAuth App (https://your.looker.instan
 - This only needs to be done once per instance
 
 
-## Code-Mode
+## Code Mode
 
-Execute Python code safely with full Looker SDK coverage within a secure sandbox environment. Constructed as an MCP tool, it dynamically inspects the Looker SDK for all public methods and injects them into the Monty sandbox safely. For detailed options, safe primitives transformations, and PKCE configurations, view the full [Code-Mode Docs](./codemode.md).
+Execute Python code safely with full Looker SDK coverage within a secure sandbox environment. Constructed as an MCP tool, it dynamically inspects the Looker SDK for all public methods and injects them into the Monty sandbox safely. For detailed options, safe primitives transformations, and PKCE configurations, view the full [Code Mode Docs](./codemode.md).
 
 ## MCP
 Built into the `lkr` is an MCP server. Right now its tools are based on helping you work within an IDE. To use it a tool like [Cursor](https://www.cursor.com/), add this to your mcp.json

{lkr_dev_cli-0.0.35 → lkr_dev_cli-0.0.36}/README.md

@@ -73,9 +73,9 @@ Go to the Looker API Explorer for Register OAuth App (https://your.looker.instan
 - This only needs to be done once per instance
 
 
-## Code-Mode
+## Code Mode
 
-Execute Python code safely with full Looker SDK coverage within a secure sandbox environment. Constructed as an MCP tool, it dynamically inspects the Looker SDK for all public methods and injects them into the Monty sandbox safely. For detailed options, safe primitives transformations, and PKCE configurations, view the full [Code-Mode Docs](./codemode.md).
+Execute Python code safely with full Looker SDK coverage within a secure sandbox environment. Constructed as an MCP tool, it dynamically inspects the Looker SDK for all public methods and injects them into the Monty sandbox safely. For detailed options, safe primitives transformations, and PKCE configurations, view the full [Code Mode Docs](./codemode.md).
 
 ## MCP
 Built into the `lkr` is an MCP server. Right now its tools are based on helping you work within an IDE. To use it a tool like [Cursor](https://www.cursor.com/), add this to your mcp.json

{lkr_dev_cli-0.0.35 → lkr_dev_cli-0.0.36}/codemode.md

@@ -1,4 +1,4 @@
-# Looker Code-Mode MCP Server
+# Looker Code Mode MCP Server
 
 `lkr code-mode` allows you to invoke a Python-based Model Context Protocol (MCP) server. It offers an AI agent the unique capacity to batched-execute Python commands securely within the Monty sandbox against your active Looker instance!
 
@@ -11,7 +11,7 @@ The tool instantiates Looker SDK natively, searches all bound methods, and passe
 ### Key Features:
 - **100% Tool Coverage:** Accesses all Looker SDK public operations smoothly without token limits.
 - **Recursive Translation:** Complex Looker models like User, Folder, Dashboard get string-converted into dictionaries immediately before ingesting them into Monty.
-- **Automatic PKCE Restarter:** Caught an invalid token? Code-Mode immediately catches `InvalidRefreshTokenError` and safely opens up your PKCE authentication browser automatically.
+- **Automatic PKCE Restarter:** Caught an invalid token? Code Mode immediately catches `InvalidRefreshTokenError` and safely opens up your PKCE authentication browser automatically.
 - **Extremely Secure:** Monty interpreter ensures isolated sandbox processing. No local filesystem accesses are exposed.
 
 ## Continuous Usage

lkr_dev_cli-0.0.36/lkr/codemode/LOCAL.md

@@ -0,0 +1,56 @@
+# Local Development Configuration for lkr:codemode
+
+To run this MCP server locally from the repository (for development or testing), you can configure your MCP client (like Claude Desktop or Cursor) to use `uv run` with the `--directory` flag pointing to this project.
+
+### Claude Desktop Configuration
+
+Add the following to your `claude_desktop_config.json` (usually located at `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "lkr_codemode_dev": {
+      "command": "/opt/homebrew/bin/uv",
+      "args": [
+        "-q",
+        "run",
+        "--directory",
+        "/path/to/lkr/cli",
+        "lkr",
+        "code-mode",
+        "run"
+      ],
+      "env": {
+        "LOOKERSDK_BASE_URL": "https://your-instance.cloud.looker.com",
+        "LOOKERSDK_CLIENT_ID": "your_client_id",
+        "LOOKERSDK_CLIENT_SECRET": "your_client_secret"
+      }
+    }
+  }
+}
+```
+
+> [!WARNING]
+> Do NOT place the directory path directly after `run` without the `--directory` flag (e.g., `["run", "/path/to/project", ...]`). `uv` will attempt to execute the directory as a command, resulting in a `Permission denied (os error 13)` error.
+
+> [!TIP]
+> **macOS GUI Apps & PATH:** Claude Desktop and Cursor do not inherit your terminal's `PATH` environment variable. If you simply use `"uv"` as the command, the app may fail to start the server because it cannot find `uv`. Using the absolute path (e.g., `/opt/homebrew/bin/uv` or `~/.cargo/bin/uv`) ensures the IDE can launch the process. Find out your path by running `which uv` in your terminal.
+
+### Cursor Integration
+
+To add this local dev server to Cursor:
+
+1. Open **Settings** (`Cmd + ,`).
+2. Go to **Features** -> **MCP**.
+3. Click **+ Add New MCP Server**.
+4. **Name**: `Looker Codemode (Local)`
+5. **Type**: `command`
+6. **Command**: `uv run -q --directory /Users/bryanweber/projects/lkr/cli lkr code-mode run`
+
+### Testing Interactively via MCP Inspector
+
+You can test the server and its tools interactively in your browser by running the MCP inspector from your terminal:
+
+```bash
+npx @modelcontextprotocol/inspector uv run -q --directory /Users/bryanweber/projects/lkr/cli lkr code-mode run
+```

{lkr_dev_cli-0.0.35 → lkr_dev_cli-0.0.36}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lkr-dev-cli"
-version = "0.0.35"
+version = "0.0.36"
 description = "lkr: a command line interface for looker"
 readme = "README.md"
 license = "MIT"