Starstruk Logo MarkStarstruk

2.0.0

HKUDS/LightRAG2.0.0Jul 28, 2026by cliffhall

AI Summary

The major version 2 introduces a unified package architecture with a shared core, supporting a Vite + React + Mantine Web UI, a scriptable CLI, and an Ink-based TUI.

Key Highlights

  • Unified package architecture combining Web UI, CLI, and TUI
  • Shared `@inspector/core` runtime ensuring consistent behavior across all clients
  • Updated Node.js requirement to version 22.19.0 or higher
  • Refactored CLI flags where `--config` is now read-only and `--catalog` controls server lists
  • Deprecation of v1 sub-packages in favor of a single package

Breaking Changes

  • Node.js version requirement increased from >= 22.7.5 to >= 22.19.0
  • CLI flag changes: `--config` is now a read-only session file, `--catalog` is the writable server list
  • Removed v1 sub-packages (`inspector-client`, `inspector-server`, `inspector-cli`)

New Features

  • New Web UI client (Vite + React + Mantine)
  • New TUI client (Ink-based)
  • New shared core runtime architecture

Full Release Notes

The v2 Inspector is now the default release.

```bash
npx @modelcontextprotocol/inspector          # web UI
npx @modelcontextprotocol/inspector --cli    # CLI
npx @modelcontextprotocol/inspector --tui    # TUI
```

## What's new

v2 ships as a single package with three clients — a Vite + React + Mantine web UI, a scriptable CLI, and an Ink-based TUI — over a shared `@inspector/core` runtime, so all three behave identically.

## Upgrading from v1

- **Node >= 22.19.0** is now required (was >= 22.7.5).
- CLI flags changed substantially. In particular `--config` now means a **read-only session file**; `--catalog` is the writable server list. See [MCP server configuration](https://github.com/modelcontextprotocol/inspector/blob/main/docs/mcp-server-configuration.md).
- The v1 sub-packages (`inspector-client`, `inspector-server`, `inspector-cli`) are deprecated and not part of v2 — v2 publishes a single package.

## v1

v1 is deprecated and receives security fixes only, published under the `v1-latest` tag:

```bash
npm i @modelcontextprotocol/inspector@v1-latest
```