Skip to content

feat: in-app links back to the project (discussion #948) - #1008

Merged
Dumbris merged 1 commit into
mainfrom
feat/948-in-app-links
Aug 19, 2026
Merged

feat: in-app links back to the project (discussion #948)#1008
Dumbris merged 1 commit into
mainfrom
feat/948-in-app-links

Conversation

@Dumbris

@Dumbris Dumbris commented Aug 19, 2026

Copy link
Copy Markdown
Member

Addresses part 1 of discussion #948 (thanks @twardoch): the running app gave a user no way back to the homepage, docs, or issue tracker. Users arrive via Homebrew / plugins / AI recommendations and never see the repo, so installs don't convert to stars/issues. This adds project links across every surface a user might look.

One source of truth per language: internal/branding (Go), ProjectLinks.swift (tray), frontend/src/config/links.ts (Web UI).

Surfaces

  • Tray menu (the app's main surface): Documentation, Report an Issue…, and About MCPProxy (standard About panel with clickable Homepage / GitHub / Documentation credit links) added before Quit.
  • Web UI: a persistent footer on every page — MCPProxy vX.Y · Homepage · GitHub · Docs · Discussions.
  • CLI: mcpproxy --version and mcpproxy --help print Homepage / GitHub / Docs in the header.
  • MCP serverInfo: the protocol-level instructions now carry the homepage/repo/docs, so an agent (and anyone reading its logs) can find the project — relevant given the tool is being AI-recommended.

Verified locally

  • Web UI footer (Chrome extension): renders persistently at the bottom on every page; all four hrefs confirmed correct (mcpproxy.app, the repo, docs.mcpproxy.app, repo/discussions).
  • Tray menu (mcpproxy-ui-test): the three items appear correctly positioned before Quit, and clicking Documentation opens docs.mcpproxy.app (built the tray, swapped it in via a temp bundle, verified, then restored the production tray).
  • All four URLs return HTTP 200.
  • mcpproxy --version / --help output checked; Go + Swift both build; new tests for the version output and serverInfo instructions.

Not in this PR

Part 2 of the discussion (product-name fragmentation — org smart-mcp-proxy vs repo mcpproxy-go vs binary mcpproxy vs site mcpproxy.app) is a separate, non-code discussion and is left for a follow-up.

🤖 Generated with Claude Code

Users arrive via Homebrew / plugins / AI recommendations and often never see
the GitHub repo, so the running app gave no way back to the homepage, docs, or
issue tracker. Add project links across every surface a user might look, from
one source of truth per language (internal/branding, ProjectLinks.swift,
config/links.ts).

- Tray menu (highest-impact surface): "Documentation", "Report an Issue…", and
  "About MCPProxy" (standard About panel with homepage/GitHub/docs credit links)
  before Quit.
- Web UI: persistent footer on every page — "MCPProxy vX.Y · Homepage · GitHub ·
  Docs · Discussions". Previously the only outbound links were buried in settings.
- CLI: `mcpproxy --version` and `--help` print Homepage / GitHub / Docs.
- MCP serverInfo: the protocol-level instructions carry the homepage/repo/docs,
  so an agent (and anyone reading its logs) can find the project.

Verified locally: Web UI footer rendered + all four hrefs correct via the Chrome
extension; tray menu items present, correctly placed before Quit, and the
Documentation action opens docs.mcpproxy.app via mcpproxy-ui-test; all four URLs
return HTTP 200.

Part 2 of the discussion (product-name fragmentation) is not addressed here.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01H7J8Yv5zr4tMQZaY3ot3Za
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying mcpproxy-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 397dffb
Status: ✅  Deploy successful!
Preview URL: https://d332fabd.mcpproxy-docs.pages.dev
Branch Preview URL: https://feat-948-in-app-links.mcpproxy-docs.pages.dev

View logs

@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

❌ Patch coverage is 33.33333% with 6 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
cmd/mcpproxy/main.go 0.00% 6 Missing ⚠️

📢 Thoughts on this report? Let us know!

@github-actions

Copy link
Copy Markdown

📦 Build Artifacts

Workflow Run: View Run
Branch: feat/948-in-app-links

Available Artifacts

  • archive-darwin-amd64 (29 MB)
  • archive-darwin-arm64 (26 MB)
  • archive-linux-amd64 (17 MB)
  • archive-linux-arm64 (15 MB)
  • archive-windows-amd64 (28 MB)
  • archive-windows-arm64 (25 MB)
  • frontend-dist-pr (0 MB)
  • installer-dmg-darwin-amd64 (23 MB)
  • installer-dmg-darwin-arm64 (20 MB)

How to Download

Option 1: GitHub Web UI (easiest)

  1. Go to the workflow run page linked above
  2. Scroll to the bottom "Artifacts" section
  3. Click on the artifact you want to download

Option 2: GitHub CLI

gh run download 32248285474 --repo smart-mcp-proxy/mcpproxy-go

Note: Artifacts expire in 14 days.

@Dumbris
Dumbris merged commit 69572f0 into main Aug 19, 2026
40 checks passed
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.

2 participants