CLI: catalog listing, auth flags, and OAuth browser UX (#1782)

* feat(cli): catalog listing, auth flags, and OAuth browser UX

Add servers/list and servers/show, --relogin / --stored-auth-only, browser
OAuth navigation with OSC 8 links, and extract method handlers under
clients/cli/src/handlers. Tracks #1781.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(cli): address #1782 review — relogin clear, stored-auth-only, docs

Clear both raw and normalized OAuth keys on --relogin; check the shared
store before bailing under --stored-auth-only mid-session; restore the
tests README link target; document servers/show redaction limits; keep
mcpi groundwork with TODO(#1432) markers.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(cli): gate OAuth browser open and harden #1782 review follow-ups

Arm auto-open only for CLI-owned interactive OAuth, honor MCP_AUTO_OPEN_ENABLED,
move --relogin clear after validation, skip keychain on servers/list, and cover
secret redaction after rehydrate.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(cli): silence disarmed OAuth URLs and round-3 review nits

Suppress authorize URL print when navigation is disarmed or
--stored-auth-only; document MCP_AUTO_OPEN_ENABLED; redact Cookie/auth
headers; keep servers/show unit tests off the OS keychain.

Co-authored-by: Cursor <cursoragent@cursor.com>

* test(cli): cover withArmedAutoOpen for the ≥90 branch gate

CI failed on cliOAuth.ts branch coverage after the auto-open arming
helper landed; exercise the armed path through runCliInteractiveOAuth.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(cli): mid-RPC unauthorized recovery and clear round-4 nits

Mirror connect's UnauthorizedError path in withCliAuthRecoveryRetry, let
MCP_AUTO_OPEN_ENABLED=true force open off-TTY, mock open-url in the
in-process runner, reject --relogin on catalog methods, restore the
__tests__ README inventory, and narrow OAuth helpers to structural client types.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(cli): reconnect after mid-RPC OAuth and finish round-5 nits

Reconnect before retrying after unauthorized recovery, guard non-OAuth
configs, decouple forceAutoOpen, move open-url mock to vitest setupFiles,
and reject --relogin with stored-auth short-circuits.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(cli): fail fast on non-TTY interactive OAuth and round-6 nits

Skip interactive OAuth without a TTY unless MCP_AUTO_OPEN_ENABLED=true;
document --stored-auth-only for CI; redact settings.metadata; reject
--relogin for stdio; clarify AuthRecoveryRequired reconnect comments.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(cli): admit interactive OAuth when stdin is a TTY (round-7)

Gate on stdin||stderr so `2>&1 | tee` still works; fold confirm/auto-open/
TTY into CliOAuthConnectOptions; rename authRequiredFailure; document
MCP_AUTO_OPEN_ENABLED=true as non-TTY admit.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(cli): fail fast on step-up without stdin (round-8)

Decline [y/N] on readline EOF/close, require a stdin TTY for the default
step-up confirmer (force-open admit is not enough), document stderr-only
browser auto-open vs stdin||stderr flow admit, and drop the alias wrapper.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(cli): allow piped step-up answers; bound silent pipes (round-9)

Drop the hard stdin-TTY gate that broke `echo y | …`. Keep EOF decline and
add a short non-TTY timeout so an open pipe that never writes cannot hang.
Clarify isTTY as admit-only; extract the readline mock factory.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(cli): keep partial piped step-up answers (round-10)

Capture readline `line` before close so `printf y` without a newline is
not treated as decline; timeout is auth_required with a distinct message;
document the 5s bound and post-confirm callback wait; pin the TTY no-timeout arm.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(cli): tighten step-up timeout messaging and TTY test (round-11)

Make the TTY no-timeout assertion use a settled flag (the Promise.race
check was vacuous), say "timed out" instead of "declined" on the pipe
bound, and document that piped answers need a newline or stdin close.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Bob Dickinson 2026-07-26 13:55:25 -07:00 • committed by GitHub
commit 33e88eac9f
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -135,6 +135,98 @@ describe("--tool-args-json", () => {
});
});
describe("CLI --relogin flag conflicts", () => {
it("rejects --relogin with --stored-auth-only", async () => {
const result = await runCli([
"--relogin",
"--stored-auth-only",
"--server-url",
"https://example.com/mcp",
"--method",
"tools/list",
]);
expectCliFailure(result);
expect(result.stderr).toMatch(
/--relogin cannot be combined with --stored-auth-only/,
);
});
it("rejects --relogin with --use-stored-auth", async () => {
const result = await runCli([
"--relogin",
"--use-stored-auth",
"--server-url",
"https://example.com/mcp",
"--method",
"tools/list",
]);
expectCliFailure(result);
expect(result.stderr).toMatch(/--use-stored-auth/);
});
it("rejects --relogin with catalog-only methods", async () => {
const result = await runCli(["--relogin", "--method", "servers/list"]);
expectCliFailure(result);
expect(result.stderr).toMatch(/servers\/list or servers\/show/);
});
it("rejects --relogin with --list-stored-auth", async () => {
const result = await runCli(["--relogin", "--list-stored-auth"]);
expectCliFailure(result);
expect(result.stderr).toMatch(/--list-stored-auth or --print-handoff/);
});
it("rejects --relogin for stdio servers", async () => {
const { command, args } = getTestMcpServerCommand();
const result = await runCli([
command,
...args,
"--relogin",
"--method",
"tools/list",
]);
expectCliFailure(result);
expect(result.stderr).toMatch(/HTTP\/SSE server URL/);
});
it("accepts --relogin and clears stored auth before connect", async () => {
// Unreachable port: proves --relogin runs (clears store) then fails connect.
const result = await runCli([
"--relogin",
"--server-url",
"http://127.0.0.1:1/mcp",
"--transport",
"http",
"--connect-timeout",
"200",
"--method",
"initialize",
]);
expectCliFailure(result);
});
});
describe("CLI --stored-auth-only wiring", () => {
it("accepts the flag and fails connect without interactive OAuth prompts", async () => {
// Unreachable host: proves the flag is accepted through parse → callMethod
// and does not hang on an interactive OAuth prompt.
const result = await runCli([
"--stored-auth-only",
"--server-url",
"http://127.0.0.1:1/mcp",
"--transport",
"http",
"--connect-timeout",
"200",
"--method",
"initialize",
]);
expectCliFailure(result);
expect(result.stderr).not.toMatch(/Please navigate to:/);
expect(result.stderr).not.toMatch(/Proceed with step-up/);
});
});
describe("MCP_CATALOG_PATH with an ad-hoc target", () => {
it("does not conflict with an ad-hoc target (env catalog is ignored)", async () => {
const { command, args } = getTestMcpServerCommand();