Skip to content

feat: add cross-platform binary releases and restructure setup docs#74

Merged
tembleking merged 2 commits intomainfrom
feat/binary-releases-and-docs
Mar 27, 2026
Merged

feat: add cross-platform binary releases and restructure setup docs#74
tembleking merged 2 commits intomainfrom
feat/binary-releases-and-docs

Conversation

@tembleking
Copy link
Copy Markdown
Member

@tembleking tembleking commented Mar 26, 2026

Enable users to install the MCP server as a standalone binary (no Go or Docker required) by building and publishing cross-platform binaries alongside the existing Docker images. The README is restructured to present all three installation methods (Go, Docker, Binary) as equal options, with CLI examples for Claude Code, Gemini CLI, and Codex CLI.

  • Add build-binaries job to the publish workflow producing archives for darwin/linux/windows across amd64/arm64/386, with SHA-256 checksums attached to each GitHub Release.
  • Reorganize the README "Running the Server" section into "Server Setup" with dedicated subsections for Go, Docker, and Binary, eliminating duplicated JSON configs across the Quickstart and Client Configuration sections.
  • Add claude mcp add, gemini mcp add, and codex mcp add CLI examples for both Go and Binary installation methods.

Build standalone binaries for darwin/linux/windows (amd64/arm64/386) in
the publish workflow, attach them with checksums to GitHub Releases, and
reorganize the README around Go/Docker/Binary installation methods with
CLI examples for Claude Code, Gemini CLI, and Codex CLI.
@tembleking tembleking requested a review from a team as a code owner March 26, 2026 10:59
Copilot AI review requested due to automatic review settings March 26, 2026 10:59
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds cross-platform standalone binary release artifacts to the existing publish pipeline and restructures the README to present Go, Docker, and Binary installation methods with updated MCP client configuration examples.

Changes:

  • Added a build-binaries workflow job to cross-compile and package server binaries for multiple OS/arch targets and attach them (plus SHA-256 checksums) to GitHub Releases.
  • Restructured README setup documentation into a new Server Setup section with Go/Docker/Binary subsections and streamlined client configuration guidance.
  • Added CLI-based MCP client setup examples (Claude Code, Gemini CLI, Codex CLI) for Go and Binary installation methods.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
README.md Reorganized setup docs, added binary install instructions, and updated client configuration examples.
.github/workflows/publish.yaml Added binary build matrix + checksum generation and attached artifacts to GitHub Releases.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@tembleking tembleking enabled auto-merge (squash) March 27, 2026 09:49
Copy link
Copy Markdown
Collaborator

@alecron alecron left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@tembleking tembleking merged commit ab971d9 into main Mar 27, 2026
6 checks passed
@tembleking tembleking deleted the feat/binary-releases-and-docs branch March 27, 2026 09:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants