From 4787c682fa2f9494441c67e2dbe5662d3966add7 Mon Sep 17 00:00:00 2001 From: Rui Chen Date: Mon, 8 Sep 2025 22:46:06 -0400 Subject: [PATCH 1/2] docs: add homebrew installation notes for mcp-publisher Signed-off-by: Rui Chen --- docs/guides/publishing/publish-server.md | 10 +++++++++- docs/reference/cli/commands.md | 9 ++------- 2 files changed, 11 insertions(+), 8 deletions(-) diff --git a/docs/guides/publishing/publish-server.md b/docs/guides/publishing/publish-server.md index 8af74bb4..f4efc424 100644 --- a/docs/guides/publishing/publish-server.md +++ b/docs/guides/publishing/publish-server.md @@ -50,7 +50,15 @@ 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 ``` -### Option B: Build from Source +### Option B: Install with Homebrew (macOS/Linux) + +Install via Homebrew (macOS/Linux): + +```bash +$ brew install mcp-publisher +``` + +### Option C: Build from Source If you prefer to build from source (requires Go 1.24+): diff --git a/docs/reference/cli/commands.md b/docs/reference/cli/commands.md index d07c1c07..a1830751 100644 --- a/docs/reference/cli/commands.md +++ b/docs/reference/cli/commands.md @@ -6,15 +6,10 @@ See the [publishing guide](../../guides/publishing/publish-server.md) for a walk ## Installation - +Install via Homebrew (macOS/Linux): ```bash -# Build from source (from repository root) -make publisher -# Binary created at ./cmd/publisher/bin/mcp-publisher - -# Install globally (optional) -cp ./cmd/publisher/bin/mcp-publisher /usr/local/bin/ +$ brew install mcp-publisher ``` ## Global Options From fcc4d0c590df53092e166f38a77c0ca06cf2326d Mon Sep 17 00:00:00 2001 From: Adam Jones Date: Tue, 9 Sep 2025 04:43:16 +0000 Subject: [PATCH 2/2] Move install sections into details blocks :house: Remote-Dev: homespace --- docs/guides/publishing/publish-server.md | 35 ++++++++++++++++-------- 1 file changed, 23 insertions(+), 12 deletions(-) diff --git a/docs/guides/publishing/publish-server.md b/docs/guides/publishing/publish-server.md index 9c2d368c..5f4a89af 100644 --- a/docs/guides/publishing/publish-server.md +++ b/docs/guides/publishing/publish-server.md @@ -17,29 +17,30 @@ By the end of this tutorial, you'll have: ## Step 1: Install the Publisher CLI -**macOS/Linux/WSL:** - -```bash -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/ -``` +
+🍺 macOS/Linux/WSL: With Homebrew (recommended) -**Install with Homebrew (macOS/Linux):** +Requires [Homebrew](https://brew.sh): ```bash brew install mcp-publisher ``` -**Windows (PowerShell):** +
+ +
+⬇️ macOS/Linux/WSL: Pre-built binaries -```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 +```bash +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/ ``` +
+
-Alternative: Build from Source +🏗️ macOS/Linux/WSL: From source -If you prefer to build from source (requires Git, Make and Go 1.24+): +Requires Git, Make and Go 1.24+: ```bash # Clone the registry repository @@ -53,6 +54,16 @@ export PATH=$PATH:$(pwd)/bin
+
+🪟 Windows PowerShell: Pre-built binaries + +```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 +``` + +
+ ## Step 2: Initialize Your server.json Navigate to your server's directory and create a template: