v0.7.0: align command name with the project name

- primary command is now mcp-gtags-server (matches repo and PyPI package);
  gtags-mcp remains as a compatibility alias so existing MCP client configs
  and background servers keep working
- all user-facing output, docs, and the installer use the new name

Author: harshithsunku

README.md

@@ -17,7 +17,7 @@ curl -fsSL https://raw.githubusercontent.com/harshithsunku/mcp-gtags-server/main
 
 Every AI coding agent — Claude Code, Cursor, Codex, you name it — answers *"where is this function defined?"* the same way: **grep the entire tree**. On a million-line C/C++ codebase that's a full scan per question, and the output is a firehose: every comment, string literal, and unrelated match, dumped straight into the model's context window.
 
-**mcp-gtags-server** replaces those scans with indexed lookups powered by [GNU Global (gtags)](https://www.gnu.org/software/global/) — the same tags engine kernel and systems developers have trusted for decades — exposed to agents over the [Model Context Protocol](https://modelcontextprotocol.io/).
+**mcp-gtags-server** replaces those scans with indexed lookups powered by [GNU Global (gtags)](https://www.gnu.org/software/global/) — the same tags engine kernel and systems developers have trusted for decades — exposed to agents over the [Model Context Protocol](https://modelcontextprotocol.io/). Built for the codebases LSP-based tools can't handle: kernel-scale C/C++, trees that don't currently compile, machines you can't sudo on.
 
 - **~100× faster per query** — milliseconds instead of seconds, at any codebase size
 - **Radically less noise** — the definition, not 7,873 lines of matches
@@ -81,18 +81,18 @@ Prefer stdio (client-launched processes) over a background server? That works to
 {
   "mcpServers": {
     "gtags": {
-      "command": "gtags-mcp"
+      "command": "mcp-gtags-server"
     }
   }
 }
 ```
 
-That's it. No indexing step, no configuration, **no per-repo setup** — 20 repos need zero extra installs. Ask your agent *"who calls `tcp_v4_rcv`?"* — the first query in any repo builds that repo's index automatically, and every query after that is answered in milliseconds. Run `gtags-mcp doctor` any time to see what the server detects, or `gtags-mcp config` to re-print the client configuration.
+That's it. No indexing step, no configuration, **no per-repo setup** — 20 repos need zero extra installs. Ask your agent *"who calls `tcp_v4_rcv`?"* — the first query in any repo builds that repo's index automatically, and every query after that is answered in milliseconds. Run `mcp-gtags-server doctor` any time to see what the server detects, or `mcp-gtags-server config` to re-print the client configuration.
 
 <details>
 <summary><b>Background server details</b> (network access, port, lifecycle)</summary>
 
-The installer runs `gtags-mcp --transport http --host 127.0.0.1 --port 8383` in the background (pid: `~/.gtags-mcp/server.pid`, log: `~/.gtags-mcp/server.log`). Environment overrides for the installer:
+The installer runs `mcp-gtags-server --transport http --host 127.0.0.1 --port 8383` in the background (pid: `~/.gtags-mcp/server.pid`, log: `~/.gtags-mcp/server.log`). Environment overrides for the installer:
 
 | Variable | Default | Meaning |
 |---|---|---|
@@ -109,7 +109,7 @@ The installer runs `gtags-mcp --transport http --host 127.0.0.1 --port 8383` in
 
 ```bash
 # 1. GNU Global — EITHER user-space (no sudo):
-gtags-mcp setup
+mcp-gtags-server setup
 #    OR a system package:
 sudo apt install global      # Debian/Ubuntu
 sudo dnf install global      # Fedora
@@ -132,7 +132,7 @@ Add to `claude_desktop_config.json` (pin the project since Desktop doesn't launc
 {
   "mcpServers": {
     "gtags": {
-      "command": "gtags-mcp",
+      "command": "mcp-gtags-server",
       "args": ["--root", "/absolute/path/to/your/project"]
     }
   }
@@ -232,7 +232,7 @@ Real projects mix languages — a C core with Python tooling, JS frontends, Go s
 - **Native languages** (C, C++, Java, PHP, Yacc, assembly) use GNU Global's fast built-in parser.
 - **Everything else** (Python, Go, Rust, JavaScript, TypeScript, Ruby, ... ~150 languages) is indexed through Global's **ctags + Pygments plugin parsers** — same index, same tools, same queries.
 
-The one-line installer (and `gtags-mcp setup`) enables this automatically — it installs universal-ctags and Pygments into user space, and the server switches to the `native-pygments` parser label on its own. Prefer system packages? Those work too:
+The one-line installer (and `mcp-gtags-server setup`) enables this automatically — it installs universal-ctags and Pygments into user space, and the server switches to the `native-pygments` parser label on its own. Prefer system packages? Those work too:
 
 ```bash
 sudo apt install exuberant-ctags python3-pygments   # Debian/Ubuntu
@@ -280,7 +280,7 @@ The tool descriptions are written to steer the model: they say *when* to use ind
 git clone https://github.com/harshithsunku/mcp-gtags-server
 cd mcp-gtags-server
 uv run --extra dev pytest       # 51 tests; e2e tests auto-skip if GNU Global is absent
-npx @modelcontextprotocol/inspector gtags-mcp    # poke at it interactively
+npx @modelcontextprotocol/inspector mcp-gtags-server    # poke at it interactively
 ```
 
 Tests build a real C project in a temp dir and exercise auto-indexing, auto-refresh, caller mapping, body extraction, pagination, user-space binary discovery, and config layering end-to-end.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcp-gtags-server"
-version = "0.6.2"
+version = "0.7.0"
 description = "Indexed code navigation for AI coding agents — replace grep scans with GNU Global (gtags) lookups over MCP. ~100x faster and radically less noise on million-line C/C++ codebases."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -46,6 +46,8 @@ dev = [
 ]
 
 [project.scripts]
+mcp-gtags-server = "gtags_mcp.server:main"
+# Legacy alias — kept so existing MCP client configs keep working.
 gtags-mcp = "gtags_mcp.server:main"
 
 [build-system]

scripts/install.sh

@@ -7,7 +7,7 @@
 #   1. Ensures `uv` is available (~/.local/bin) — installs it if missing.
 #   2. Installs OR UPDATES the mcp-gtags-server package (release-driven:
 #      every GitHub tag published to PyPI is picked up automatically).
-#   3. Runs `gtags-mcp setup`: installs GNU Global (prebuilt binaries when
+#   3. Runs `mcp-gtags-server setup`: installs GNU Global (prebuilt binaries when
 #      available, otherwise built from source) plus universal-ctags and
 #      Pygments into ~/.gtags-mcp. On updates, outdated toolchains are
 #      wiped and reinstalled automatically.
@@ -45,7 +45,7 @@ PID_FILE="$GTAGS_HOME/server.pid"
 LOG_FILE="$GTAGS_HOME/server.log"
 
 installed_version() {
-    command -v gtags-mcp >/dev/null 2>&1 && gtags-mcp --version 2>/dev/null | awk '{print $NF}' || true
+    command -v mcp-gtags-server >/dev/null 2>&1 && mcp-gtags-server --version 2>/dev/null | awk '{print $NF}' || true
 }
 
 server_running() {
@@ -64,7 +64,7 @@ stop_server() {
 start_server() {
     mkdir -p "$GTAGS_HOME"
     say "Starting background MCP server on ${HOST}:${PORT} ..."
-    nohup gtags-mcp --transport http --host "$HOST" --port "$PORT" \
+    nohup mcp-gtags-server --transport http --host "$HOST" --port "$PORT" \
         >> "$LOG_FILE" 2>&1 &
     echo $! > "$PID_FILE"
     sleep 2
@@ -80,15 +80,15 @@ start_server() {
 print_config() {
     echo
     if server_running; then
-        gtags-mcp config --transport http --host "$HOST" --port "$PORT"
+        mcp-gtags-server config --transport http --host "$HOST" --port "$PORT"
         echo
         echo "  (Prefer per-client processes? The stdio variant also works:)"
-        echo "      claude mcp add --scope user gtags -- gtags-mcp"
+        echo "      claude mcp add --scope user gtags -- mcp-gtags-server"
     else
-        gtags-mcp config
+        mcp-gtags-server config
     fi
     echo
-    echo "  Sanity check any time:   gtags-mcp doctor"
+    echo "  Sanity check any time:   mcp-gtags-server doctor"
     echo "  No per-repo installs — every repo is indexed automatically on"
     echo "  the first query."
 }
@@ -105,7 +105,7 @@ fi
 BEFORE="$(installed_version)"
 say "Checking mcp-gtags-server ..."
 uv tool install --upgrade --quiet mcp-gtags-server
-command -v gtags-mcp >/dev/null 2>&1 || die "gtags-mcp not on PATH after install"
+command -v mcp-gtags-server >/dev/null 2>&1 || die "mcp-gtags-server not on PATH after install"
 AFTER="$(installed_version)"
 
 UPDATED=0
@@ -120,7 +120,7 @@ fi
 
 # --- 3. gtags toolchain (idempotent; self-heals after updates) ----------------
 say "Verifying gtags toolchain in $GTAGS_HOME (no sudo) ..."
-gtags-mcp setup
+mcp-gtags-server setup
 
 # --- 4. PATH persistence ------------------------------------------------------
 ensure_path_line='export PATH="$HOME/.local/bin:$PATH"'

src/gtags_mcp/server.py

@@ -7,7 +7,7 @@
 it before each query — so agents never have to think about indexing.
 
 GNU Global (``gtags``/``global``) is resolved through user-space locations
-first (see :mod:`gtags_mcp.toolchain`); ``gtags-mcp setup`` installs it
+first (see :mod:`gtags_mcp.toolchain`); ``mcp-gtags-server setup`` installs it
 without root when it is missing.
 """
 
@@ -99,7 +99,7 @@ def _check_global_installed() -> str | None:
     if toolchain.find_global(_bin_dir) is None or toolchain.find_gtags(_bin_dir) is None:
         return (
             "Error: GNU Global (gtags/global) was not found. "
-            "Install it into user space with `gtags-mcp setup` (no sudo needed), "
+            "Install it into user space with `mcp-gtags-server setup` (no sudo needed), "
             "or via a system package (`apt install global`, `brew install global`), "
             "or point GTAGS_MCP_BIN_DIR / --bin-dir / `bin_dir` in .gtags-mcp.toml "
             "at a directory containing the binaries."
@@ -1093,7 +1093,7 @@ def index_project(project_root: str | None = None) -> str:
     if non_native:
         message += (
             f" Note: {', '.join(sorted(non_native))} files were NOT indexed — "
-            "run `gtags-mcp setup` (installs ctags + Pygments into user space, "
+            "run `mcp-gtags-server setup` (installs ctags + Pygments into user space, "
             "no sudo) to enable multi-language indexing."
         )
     return message
@@ -1170,12 +1170,12 @@ def _client_config_text(transport: str, host: str, port: int) -> str:
             "MCP client configuration (stdio transport):",
             "",
             "  Claude Code (once per device, all repos):",
-            "      claude mcp add --scope user gtags -- gtags-mcp",
+            "      claude mcp add --scope user gtags -- mcp-gtags-server",
             "",
             "  Cursor / any MCP client — global settings or .mcp.json:",
             "      {",
             '        "mcpServers": {',
-            '          "gtags": { "command": "gtags-mcp" }',
+            '          "gtags": { "command": "mcp-gtags-server" }',
             "        }",
             "      }",
         ]
@@ -1186,7 +1186,7 @@ def main() -> None:
     """Entry point: serve MCP over stdio/HTTP, or run a maintenance subcommand."""
     global _default_root, _forced_label, _bin_dir
     parser = argparse.ArgumentParser(
-        prog="gtags-mcp",
+        prog="mcp-gtags-server",
         description=(
             "MCP server exposing GNU Global (gtags) code navigation. "
             "Subcommands: 'setup' installs the toolchain into user space "
@@ -1274,7 +1274,7 @@ def main() -> None:
         sys.exit(toolchain.run_setup(with_ctags=not args.no_ctags, force=args.force))
     if args.command == "doctor":
         root, _ = _effective_root(args.root)
-        print(f"gtags-mcp doctor (v{_package_version()})")
+        print(f"mcp-gtags-server doctor (v{_package_version()})")
         print(toolchain.doctor_report(project_root=root))
         label = _gtags_label(root)
         print(f"  parser label : {label or 'native (C/C++/Java/PHP/asm only)'}")
@@ -1286,7 +1286,7 @@ def main() -> None:
         mcp.settings.host = args.host
         mcp.settings.port = args.port
         print(
-            f"gtags-mcp v{_package_version()} — streamable HTTP server on "
+            f"mcp-gtags-server v{_package_version()} — streamable HTTP server on "
             f"{args.host}:{args.port}\n",
             flush=True,
         )
@@ -1298,11 +1298,11 @@ def main() -> None:
         return
     if sys.stdin.isatty():
         print(
-            "gtags-mcp: serving MCP over stdio — this mode is meant to be "
+            "mcp-gtags-server: serving MCP over stdio — this mode is meant to be "
             "launched by an MCP client (Claude Code, Cursor, ...), not typed "
             "into.\n"
-            "  Maintenance commands:  gtags-mcp doctor | config | setup | help\n"
-            "  Shared background server:  gtags-mcp --transport http\n"
+            "  Maintenance commands:  mcp-gtags-server doctor | config | setup | help\n"
+            "  Shared background server:  mcp-gtags-server --transport http\n"
             "  Press Ctrl+C to exit.",
             file=sys.stderr,
             flush=True,

src/gtags_mcp/toolchain.py

@@ -2,7 +2,7 @@
 
 The server never assumes ``gtags``/``global`` come from a system package.
 Binaries are resolved through a search order that puts user-space locations
-first, and ``gtags-mcp setup`` can install the whole toolchain without root:
+first, and ``mcp-gtags-server setup`` can install the whole toolchain without root:
 
 1. an explicit ``bin_dir`` (tool argument, ``--bin-dir``, ``GTAGS_MCP_BIN_DIR``
    env var, or ``bin_dir`` in a config file),
@@ -577,7 +577,7 @@ def run_setup(with_ctags: bool = True, force: bool = False, log=print) -> int:
     differs from the pinned ``GLOBAL_VERSION`` (e.g. after the package was
     upgraded), the whole managed home is removed and reinstalled fresh.
     """
-    log(f"gtags-mcp setup — installing into {managed_home()} (no sudo needed)")
+    log(f"mcp-gtags-server setup — installing into {managed_home()} (no sudo needed)")
 
     managed_version = _managed_global_version()
     if managed_version and managed_version != GLOBAL_VERSION:
@@ -663,12 +663,12 @@ def version_of(exe: str | None) -> str:
         )
     if not find_global(project_root=project_root):
         lines.append(
-            "\n  GNU Global is missing — run `gtags-mcp setup` to install it "
+            "\n  GNU Global is missing — run `mcp-gtags-server setup` to install it "
             "into user space (no sudo needed)."
         )
     elif not pygments_available():
         lines.append(
             "\n  Pygments is missing — multi-language references are disabled. "
-            "Re-run `gtags-mcp setup` to install it into user space."
+            "Re-run `mcp-gtags-server setup` to install it into user space."
         )
     return "\n".join(lines)

tests/test_toolchain.py

@@ -171,7 +171,7 @@ def test_doctor_report_mentions_setup_when_missing(tmp_path, monkeypatch):
     # Hide any system global from the report.
     monkeypatch.setattr(toolchain.shutil, "which", lambda name: None)
     report = toolchain.doctor_report()
-    assert "gtags-mcp setup" in report
+    assert "mcp-gtags-server setup" in report
     assert "NOT FOUND" in report