From 55e76066f4416ddd36672840f35574faf6a07e92 Mon Sep 17 00:00:00 2001 From: adam jones Date: Mon, 8 Sep 2025 21:34:15 -0700 Subject: [PATCH] docs: Simplify publisher CLI installation instructions (#382) ## Summary Simplifies the installation instructions in the publisher guide by: - Auto-detecting platform using `uname` and PowerShell built-ins for a single copy-paste command - Moving build-from-source to a collapsible details section to emphasize the recommended pre-built binary approach - Removing unnecessary `chmod +x` since tar preserves executable permissions - Adding explicit support for WSL This makes it much easier for users to get started - they can now just copy one command instead of picking from 4+ platform-specific options. --- docs/guides/publishing/publish-server.md | 45 ++++++++---------------- 1 file changed, 14 insertions(+), 31 deletions(-) diff --git a/docs/guides/publishing/publish-server.md b/docs/guides/publishing/publish-server.md index 8af74bb..4ad658c 100644 --- a/docs/guides/publishing/publish-server.md +++ b/docs/guides/publishing/publish-server.md @@ -17,42 +17,23 @@ By the end of this tutorial, you'll have: ## Step 1: Install the Publisher CLI -You can either download a pre-built binary or build from source. - -### Option A: Download Pre-built Binary (Recommended) - -Download the latest release for your platform: +**macOS/Linux/WSL:** ```bash -# macOS Apple Silicon (M1/M2/M3) -curl -L https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_darwin_arm64.tar.gz | tar xz - -# macOS Intel -curl -L https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_darwin_amd64.tar.gz | tar xz - -# Linux x86_64 -curl -L https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_linux_amd64.tar.gz | tar xz - -# Linux ARM64 -curl -L https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_linux_arm64.tar.gz | tar xz - -# Windows x86_64 (PowerShell) -Invoke-WebRequest -Uri "https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_windows_amd64.tar.gz" -OutFile "mcp-publisher.tar.gz" -tar xf mcp-publisher.tar.gz - -# Windows ARM64 (PowerShell) -Invoke-WebRequest -Uri "https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_windows_arm64.tar.gz" -OutFile "mcp-publisher.tar.gz" -tar xf mcp-publisher.tar.gz - -# Add to PATH (macOS/Linux) -chmod +x mcp-publisher && sudo mv mcp-publisher /usr/local/bin/ - -# Add to PATH (Windows): Move mcp-publisher.exe to a directory in your PATH +curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher && sudo mv mcp-publisher /usr/local/bin/ ``` -### Option B: Build from Source +**Windows (PowerShell):** -If you prefer to build from source (requires Go 1.24+): +```powershell +$arch = if ([System.Runtime.InteropServices.RuntimeInformation]::ProcessArchitecture -eq "Arm64") { "arm64" } else { "amd64" }; Invoke-WebRequest -Uri "https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_windows_$arch.tar.gz" -OutFile "mcp-publisher.tar.gz"; tar xf mcp-publisher.tar.gz mcp-publisher.exe; rm mcp-publisher.tar.gz +# Move mcp-publisher.exe to a directory in your PATH +``` + +
+Alternative: Build from Source + +If you prefer to build from source (requires Git, Make and Go 1.24+): ```bash # Clone the registry repository @@ -64,6 +45,8 @@ make publisher export PATH=$PATH:$(pwd)/bin ``` +
+ ## Step 2: Initialize Your server.json Navigate to your server's directory and create a template: