mcp2mcpb 0.1.0__tar.gz

mcp2mcpb-0.1.0/.github/workflows/build-mcpb.yml

@@ -0,0 +1,162 @@
+name: Build .mcpb bundle (reusable)
+
+# Reusable workflow for MCP server authors. Add one job to your release
+# pipeline:
+#
+#   jobs:
+#     bundle:
+#       uses: Anselmoo/mcp2mcpb/.github/workflows/build-mcpb.yml@v1
+#       with:
+#         package: my-mcp-server
+#         registry: pypi
+#         mode: complete
+#
+# Self-contained: it installs the published `mcp2mcpb` package from PyPI
+# and runs the CLI directly (it does NOT depend on the composite action tag).
+# Launch recipe (runner/entry-script/extras/subcommand/transport) is optional —
+# omit it and the converter auto-detects from the package (and any in-package
+# [tool.mcpb]/mcpb.toml). On a `release` event the bundle is attached to the
+# release automatically.
+
+on:
+  workflow_call:
+    inputs:
+      package:
+        description: Package name on PyPI or npm.
+        required: true
+        type: string
+      registry:
+        description: "'pypi' or 'npm'."
+        required: false
+        type: string
+        default: pypi
+      version:
+        description: Exact version to bundle. Defaults to the release tag (v-stripped).
+        required: false
+        type: string
+        default: ""
+      mode:
+        description: "'complete' (vendor deps) or 'reference' (uvx/npx)."
+        required: false
+        type: string
+        default: complete
+      python-version:
+        description: Python version used when vendoring dependencies.
+        required: false
+        type: string
+        default: "3.12"
+      output-dir:
+        description: Directory where .mcpb files are written.
+        required: false
+        type: string
+        default: dist
+      mcp2mcpb-version:
+        description: Version spec of the mcp2mcpb package to install from PyPI.
+        required: false
+        type: string
+        default: ">=0.1"
+      runner:
+        description: "Launch runner: uvx | npx | uv-run | python | node (empty = infer)."
+        required: false
+        type: string
+        default: ""
+      entry-script:
+        description: Console script (PyPI) / bin name (npm) to launch (empty = auto-detect).
+        required: false
+        type: string
+        default: ""
+      extras:
+        description: Space-separated package extras (PyPI/uv only), e.g. "mcp".
+        required: false
+        type: string
+        default: ""
+      subcommand:
+        description: Arguments appended after the entry script, e.g. "start-mcp-server".
+        required: false
+        type: string
+        default: ""
+      transport:
+        description: "Transport flag: stdio | none | auto (empty = auto)."
+        required: false
+        type: string
+        default: ""
+      no-probe:
+        description: Disable the --help auto-detection probe.
+        required: false
+        type: boolean
+        default: false
+      attach-to-release:
+        description: Attach the .mcpb files to the GitHub Release on a 'release' event.
+        required: false
+        type: boolean
+        default: true
+
+jobs:
+  build-mcpb:
+    name: Build .mcpb bundle
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write    # needed to attach assets to a release
+    steps:
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: latest
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ inputs.python-version }}
+
+      - name: Install mcp2mcpb
+        shell: bash
+        env:
+          SPEC: ${{ inputs.mcp2mcpb-version }}
+        run: uv pip install --system "mcp2mcpb${SPEC}"
+
+      - name: Resolve version
+        id: resolve-version
+        shell: bash
+        env:
+          VERSION_INPUT: ${{ inputs.version }}
+        run: |
+          VERSION="$VERSION_INPUT"
+          if [[ -z "$VERSION" && -n "$GITHUB_REF_NAME" ]]; then
+            VERSION="${GITHUB_REF_NAME#v}"
+          fi
+          if [[ -z "$VERSION" ]]; then
+            echo "Error: could not resolve version. Set the 'version' input." >&2
+            exit 1
+          fi
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Build .mcpb bundle
+        shell: bash
+        env:
+          PACKAGE: ${{ inputs.package }}
+          REGISTRY: ${{ inputs.registry }}
+          VERSION: ${{ steps.resolve-version.outputs.version }}
+          MODE: ${{ inputs.mode }}
+          OUTPUT_DIR: ${{ inputs.output-dir }}
+          RUNNER: ${{ inputs.runner }}
+          ENTRY_SCRIPT: ${{ inputs.entry-script }}
+          EXTRAS: ${{ inputs.extras }}
+          SUBCOMMAND: ${{ inputs.subcommand }}
+          TRANSPORT: ${{ inputs.transport }}
+          NO_PROBE: ${{ inputs.no-probe }}
+        run: |
+          ARGS=( "$PACKAGE" --registry "$REGISTRY" --pin "$VERSION"
+                 --mode "$MODE" --output "$OUTPUT_DIR" )
+          [[ -n "$RUNNER" ]]       && ARGS+=( --runner "$RUNNER" )
+          [[ -n "$ENTRY_SCRIPT" ]] && ARGS+=( --entry-script "$ENTRY_SCRIPT" )
+          for extra in $EXTRAS; do ARGS+=( --extra "$extra" ); done
+          [[ -n "$SUBCOMMAND" ]]   && ARGS+=( --subcommand "$SUBCOMMAND" )
+          [[ -n "$TRANSPORT" ]]    && ARGS+=( --transport "$TRANSPORT" )
+          [[ "$NO_PROBE" == "true" ]] && ARGS+=( --no-probe )
+          python -m mcp2mcpb "${ARGS[@]}"
+
+      - name: Attach to GitHub Release
+        if: inputs.attach-to-release && github.event_name == 'release'
+        uses: softprops/action-gh-release@v2
+        with:
+          files: ${{ inputs.output-dir }}/*.mcpb

mcp2mcpb-0.1.0/.github/workflows/build-upstream.yml

@@ -0,0 +1,137 @@
+name: Build .mcpb bundles (upstream)
+
+on:
+  workflow_dispatch:
+    inputs:
+      package:
+        description: Package name
+        required: true
+        type: string
+      version:
+        description: Exact upstream version to bundle
+        required: true
+        type: string
+      registry:
+        description: pypi or npm
+        required: true
+        default: pypi
+        type: choice
+        options: [pypi, npm]
+
+jobs:
+  build:
+    name: Build (${{ matrix.platform }})
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            platform: linux-x86_64
+          - os: macos-13
+            platform: macos-x86_64
+          - os: macos-latest
+            platform: macos-arm64
+          - os: windows-latest
+            platform: windows-x86_64
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install mcp2mcpb
+        run: uv pip install --system -e ".[dev]"
+
+      - name: Build .mcpb bundle
+        run: |
+          python -m mcp2mcpb \
+            "${{ inputs.package }}" \
+            --registry "${{ inputs.registry }}" \
+            --pin "${{ inputs.version }}" \
+            --mode complete \
+            --output dist/
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: mcpb-${{ matrix.platform }}
+          path: dist/*.mcpb
+          if-no-files-found: error
+
+  release:
+    name: Create GitHub Release
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Download all platform artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist/
+          merge-multiple: true
+
+      - name: List produced files
+        run: ls -lh dist/*.mcpb
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: "${{ inputs.package }}-v${{ inputs.version }}"
+          name: "${{ inputs.package }} ${{ inputs.version }}"
+          files: dist/*.mcpb
+          generate_release_notes: false
+          body: |
+            ## ${{ inputs.package }} ${{ inputs.version }}
+
+            One-click `.mcpb` bundles for Claude Desktop and any MCPB-compatible client.
+
+            ### Installation
+
+            1. Download the `.mcpb` file for your platform below.
+            2. Open Claude Desktop → Settings → Extensions.
+            3. Drag and drop the `.mcpb` file into the Extensions page.
+
+            ### Platform files
+
+            | File | Platform |
+            |------|----------|
+            | `*-linux-x86_64.mcpb` | Linux (x86_64) |
+            | `*-macos-x86_64.mcpb` | macOS (Intel) |
+            | `*-macos-arm64.mcpb` | macOS (Apple Silicon) |
+            | `*-windows-x86_64.mcpb` | Windows (x86_64) |
+
+            ---
+            *Built by [mcp2mcpb](https://github.com/Anselmoo/mcp2mcpb)*
+
+      - name: Update versions.json
+        run: |
+          python - <<'EOF'
+          import json
+          from pathlib import Path
+          f = Path("versions.json")
+          versions = json.loads(f.read_text()) if f.exists() else {}
+          versions["${{ inputs.registry }}/${{ inputs.package }}"] = "${{ inputs.version }}"
+          f.write_text(json.dumps(versions, indent=2, sort_keys=True) + "\n")
+          EOF
+
+      - name: Commit updated versions.json
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add versions.json
+          git diff --cached --quiet || git commit -m \
+            "chore(versions): ${{ inputs.package }} → ${{ inputs.version }}"
+          git push

mcp2mcpb-0.1.0/.github/workflows/check-upstream.yml

@@ -0,0 +1,62 @@
+name: Check upstream releases
+
+on:
+  schedule:
+    - cron: "0 6 * * *"     # daily 06:00 UTC
+  workflow_dispatch:
+    inputs:
+      package:
+        description: Package name (e.g. mcp-server-fetch)
+        required: true
+        type: string
+      registry:
+        description: pypi or npm
+        required: true
+        default: pypi
+        type: choice
+        options: [pypi, npm]
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    permissions:
+      actions: write    # needed to trigger workflow_dispatch
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install httpx
+        run: pip install httpx --quiet
+
+      - name: Check for new version
+        id: check
+        env:
+          PACKAGE: ${{ inputs.package || 'mcp-server-fetch' }}
+          REGISTRY: ${{ inputs.registry || 'pypi' }}
+        run: |
+          python scripts/check_version.py \
+            --package "$PACKAGE" \
+            --registry "$REGISTRY" \
+            --versions-file versions.json
+
+      - name: Trigger build if new version found
+        if: steps.check.outputs.new_version != ''
+        uses: actions/github-script@v7
+        with:
+          script: |
+            await github.rest.actions.createWorkflowDispatch({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              workflow_id: 'build-upstream.yml',
+              ref: 'main',
+              inputs: {
+                package:  '${{ steps.check.outputs.package }}',
+                version:  '${{ steps.check.outputs.new_version }}',
+                registry: '${{ steps.check.outputs.registry }}',
+              },
+            })

mcp2mcpb-0.1.0/.github/workflows/cicd.yml

@@ -0,0 +1,295 @@
+name: 🚀 CI/CD
+
+on:
+  push:
+    branches:
+      - main
+      - feat/**
+      - fix/**
+      - chore/**
+      - docs/**
+      - refactor/**
+      - test/**
+      - ci/**
+      - perf/**
+      - style/**
+      - build/**
+    tags: ["v*.*.*"]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-cd-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  PACKAGE_NAME: "mcp2mcpb"
+  PYTHON_VERSION: "3.12"
+
+jobs:
+  lint:
+    name: 🔍 Lint & types
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0   # rrt needs history for branch/commit/changelog checks
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Sync dependencies
+        run: uv sync --extra dev
+
+      - name: Ruff lint
+        run: uv run ruff check src tests
+
+      - name: Ruff format check
+        run: uv run ruff format --check src tests
+
+      - name: ty type check
+        run: uv run ty check
+
+      - name: Validate release policy (rrt)
+        if: github.event_name == 'pull_request' || startsWith(github.ref, 'refs/tags/')
+        uses: Anselmoo/repo-release-tools@v1.9.0
+        with:
+          check-branch-name: "true"
+          check-commit-subject: "true"
+          check-changelog: "true"
+          changelog-strategy: "release-only"
+          check-release-health: "true"
+
+  test:
+    name: 🧪 Tests (${{ matrix.python-version }})
+    needs: lint
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Sync dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests
+        run: uv run pytest --cov=src/mcp2mcpb --cov-report=xml
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage.xml
+          flags: python-${{ matrix.python-version }}
+          name: mcp2mcpb-${{ matrix.python-version }}
+          fail_ci_if_error: false
+          verbose: false
+
+  build:
+    name: 📦 Build package
+    needs: test
+    if: github.event_name != 'pull_request'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Check distributions
+        run: uvx twine check dist/*
+
+      - name: Upload distribution artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  sbom:
+    name: 📜 Generate SBOM
+    needs: build
+    if: github.event_name != 'pull_request'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Generate SBOM
+        uses: anchore/sbom-action@v0
+        with:
+          format: spdx-json
+          output-file: sbom.spdx.json
+          path: .
+
+      - name: Upload SBOM artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: sbom
+          path: sbom.spdx.json
+
+  attest:
+    name: 🛡️ Attest build provenance
+    needs: build
+    if: github.event_name != 'pull_request'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+      attestations: write
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Generate provenance attestation
+        uses: actions/attest-build-provenance@v4
+        with:
+          subject-path: dist/*
+
+  publish-testpypi:
+    name: 🧪 Publish to TestPyPI
+    needs: [build, sbom, attest]
+    if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v'))
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/mcp2mcpb
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true
+
+  verify-testpypi:
+    name: 🧪 Verify TestPyPI package
+    needs: publish-testpypi
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Upgrade pip
+        run: python -m pip install --upgrade pip
+
+      - name: Install package from TestPyPI
+        shell: bash
+        run: |
+          set -euo pipefail
+          VERSION="${GITHUB_REF_NAME#v}"
+          for attempt in {1..8}; do
+            if python -m pip install \
+              --index-url https://test.pypi.org/simple/ \
+              --extra-index-url https://pypi.org/simple/ \
+              "${PACKAGE_NAME}==${VERSION}"; then
+              break
+            fi
+            if [ "$attempt" -eq 8 ]; then
+              echo "Package was not installable from TestPyPI after retries."
+              exit 1
+            fi
+            echo "Retrying TestPyPI install in 20s (attempt ${attempt}/8)..."
+            sleep 20
+          done
+
+      - name: Smoke test installed CLI
+        run: mcp2mcpb --version
+
+  publish-pypi:
+    name: 🚀 Publish to PyPI
+    needs: [build, sbom, attest, publish-testpypi, verify-testpypi]
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/p/mcp2mcpb
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: 🎁 Create GitHub release
+    needs: [publish-pypi, sbom]
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Download SBOM artifact
+        uses: actions/download-artifact@v8
+        with:
+          name: sbom
+          path: .
+
+      - name: Create GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: |
+            dist/*
+            sbom.spdx.json

mcp2mcpb-0.1.0/.gitignore

@@ -0,0 +1,42 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+.eggs/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# uv
+.uv/
+
+# Testing / coverage
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+
+# IDEs
+.idea/
+.vscode/
+
+# OS
+.DS_Store
+
+# Local Claude Code settings
+.claude/settings.local.json
+
+# mcp2mcpb artifacts
+*.mcpb
+.mcpb-cache/
+docs/