From 2d870bd2e0a00c87f7961fa9e04c4b0cca439fc9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?d=20=F0=9F=94=B9?= <258577966+voidborne-d@users.noreply.github.com> Date: Mon, 11 May 2026 17:20:32 +0800 Subject: [PATCH] docs(complete): align publish CLI flags with implementation (#767) complete.md still documented three flags for `mcp-publisher publish` (`--file=PATH`, `--registry=URL`, `--dry-run`) that the CLI does not parse. Reading the publisher source confirms the actual interface is a positional `PATH` argument (default `./server.json`); registry URL is bound at login time via the saved token, and "validate without publishing" is a separate `mcp-publisher validate` subcommand. Per the discussion on the earlier flag-implementation attempt (#771), maintainers preferred fixing the documentation rather than adding the unimplemented flags. `docs/reference/cli/commands.md` was already updated to the correct positional shape, but `complete.md` (which mirrors the docs/ tree into a single file for LLM/quickstart use) had drifted out of sync. This change syncs the `mcp-publisher publish` block in `complete.md` with the canonical version in `docs/reference/cli/commands.md`, removing the three stale flags and the corresponding example. Closes #767. Co-authored-by: Claude Opus 4.7 (1M context) --- complete.md | 18 +++++++----------- 1 file changed, 7 insertions(+), 11 deletions(-) diff --git a/complete.md b/complete.md index 2355e4b5..e9040fa3 100644 --- a/complete.md +++ b/complete.md @@ -1991,30 +1991,26 @@ For detailed guidance on the publishing process, see the [publishing guide](../. **Usage:** ```bash -mcp-publisher publish [options] +mcp-publisher publish [PATH] ``` **Options:** -- `--file=PATH` - Path to server.json (default: `./server.json`) -- `--registry=URL` - Registry URL override -- `--dry-run` - Validate without publishing +- `PATH` - Path to server.json (default: `./server.json`) **Process:** 1. Validates `server.json` against schema -2. Verifies package ownership (see [Official Registry Requirements](../server-json/official-registry-requirements.md)) -3. Checks namespace authentication -4. Publishes to registry +2. Publishes the `server.json` to the registry server URL specified in the login token +3. Server: Verifies package ownership (see [Official Registry Requirements](../server-json/official-registry-requirements.md)) +4. Server: Checks namespace authentication +5. Server: Publishes to registry **Example:** ```bash # Basic publish mcp-publisher publish -# Dry run validation -mcp-publisher publish --dry-run - # Custom file location -mcp-publisher publish --file=./config/server.json +mcp-publisher publish ./config/server.json ``` ### `mcp-publisher logout`