fix: add reliable local Inspector launcher

Author: neha-nupoor

README.md

@@ -43,6 +43,19 @@ uv run vocagateway-mcp
 destination before it opens an audio file. The server does not log bearer tokens,
 audio bytes, or transcript content.
 
+### Interactive Inspector test
+
+With a local VocaGateway running at `127.0.0.1:8765`, launch the Inspector with
+the included wrapper. It loads the existing local gateway token without printing
+it and avoids relying on an editable-package console-script wrapper:
+
+```sh
+npx @modelcontextprotocol/inspector bash \
+  /absolute/path/to/vocagateway-mcp/scripts/inspect-local.sh
+```
+
+Connect, then call `get_gateway_status`, `list_models`, and `transcribe_file`.
+
 Container images use the same stdio entry point:
 
 ```sh

scripts/inspect-local.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+repo_dir="$(cd -- "${script_dir}/.." && pwd)"
+
+export PYTHONPATH="${repo_dir}/src${PYTHONPATH:+:${PYTHONPATH}}"
+export VOCAGATEWAY_URL="${VOCAGATEWAY_URL:-http://127.0.0.1:8765}"
+
+if [[ -z "${VOCAGATEWAY_TOKEN:-}" ]]; then
+  token_file="${VOCAGATEWAY_TOKEN_FILE:-${HOME}/.config/vocagateway/token}"
+  if [[ ! -r "${token_file}" ]]; then
+    echo "VocaGateway token file is not readable: ${token_file}" >&2
+    exit 1
+  fi
+  export VOCAGATEWAY_TOKEN="$(<"${token_file}")"
+fi
+
+exec "${repo_dir}/.venv/bin/python" -m vocagateway_mcp.server