Skip to content

Use versioned MCPB download links instead of 'latest' #199

@polaz

Description

@polaz

Problem

MCPB download links on the documentation site use gitlab-mcp-latest.mcpb which:

  1. Gets intercepted by Vue Router (opens as HTML page instead of downloading)
  2. Doesn't indicate which version the user is downloading

Solution

  1. Add __VERSION__ placeholder to template files (.md.in)
  2. inject-tool-refs.ts replaces placeholder with actual version from:
    • RELEASE_VERSION env var (set by CI from latest GitHub release tag)
    • Fallback: package.json version
  3. Add download attribute to prevent Vue Router interception
  4. Links now use versioned filenames: gitlab-mcp-6.43.0.mcpb

Changes

  • src/cli/inject-tool-refs.ts - Add __VERSION__ placeholder support
  • .github/workflows/docs.yml - Pass RELEASE_VERSION env to inject-tool-refs
  • docs/index.md.in - Use __VERSION__ in download link
  • docs/guide/installation/claude-desktop.md.in - Use __VERSION__ in download links
  • docs/clients/claude-desktop.mddocs/clients/claude-desktop.md.in - Convert to template
  • docs/.vitepress/config.mts - Update ignoreDeadLinks pattern for versioned files

Closes #199

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions