feat: pkgx mcp registry

Author: elasticdotventures

.github/workflows/docker.yml

@@ -54,3 +54,43 @@ jobs:
           platforms: linux/amd64
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
+
+  publish-mcp:
+    needs: build-and-push
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install MCP Publisher
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" \
+            | tar xz mcp-publisher
+          chmod +x mcp-publisher
+
+      - name: Prepare server manifest
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/v}
+          IMAGE_REPO=$(echo "${GITHUB_REPOSITORY}" | tr '[:upper:]' '[:lower:]')
+          IMAGE="ghcr.io/${IMAGE_REPO}:$VERSION"
+          jq --arg v "$VERSION" --arg image "$IMAGE" '
+            .version = $v
+            | .packages = (.packages // [] | map(
+                if .registryType == "oci" then
+                  (.identifier = $image)
+                else .
+                end
+                | (if has("version") then .version = $v else . end)
+              ))
+          ' server.json > server.publish.json
+          mv server.publish.json server.json
+
+      - name: Login to MCP Registry
+        run: ./mcp-publisher login github-oidc
+
+      - name: Publish to MCP Registry
+        run: ./mcp-publisher publish

CHANGELOG.md

@@ -7,3 +7,5 @@
 - add an Alpine-based Docker image build + entrypoint script plus usage docs for container publishing
 - publish the container automatically to GHCR using `.github/workflows/docker.yml`
 - update Docker builder stage to the latest stable Rust toolchain (1.91.1) for smaller, faster binaries
+- add a self-contained pkgx pantry (`pkgx/`) with build/test metadata so `pkgx cratedocs` can install the server via the pkgx runtime, plus README instructions for using and upstreaming it
+- add `just install-pkgx` to verify the pkgx pantry wiring end-to-end (falls back to a helpful message until the package is mirrored onto dist.pkgx.dev)

Cargo.lock

@@ -28,6 +28,8 @@ COPY docker/entrypoint.sh /entrypoint.sh
 
 RUN chmod +x /entrypoint.sh
 
+LABEL io.modelcontextprotocol.server.name="io.github.promptexecution/rust-cargo-docs-rag-mcp"
+
 EXPOSE 8080
 
 ENV CRATEDOCS_MODE=http \

Dockerfile

@@ -15,8 +15,24 @@ git clone https://github.com/promptexecution/rust-cargo-docs-rag-mcp.git
 cd rust-cargo-docs-rag-mcp
 cargo build --release
 cargo install --path .
+# Or install the pkgx-managed binary and check its version
+just install-pkgx
 ```
 
+### Installing with pkgx
+
+The repository includes a mini [pkgx pantry](./pkgx) so you can build and run the CLI through `pkgx` without touching your global toolchain:
+
+```bash
+git clone https://github.com/promptexecution/rust-cargo-docs-rag-mcp.git
+cd rust-cargo-docs-rag-mcp
+export PKGX_PANTRY_PATH=$PWD/pkgx
+export PKGX_PANTRY_DIR=$PWD/pkgx    # pkgx^2 compatibility
+pkgx cratedocs version
+```
+
+`pkgx` will download the tagged source tarball, compile `cratedocs` with the required Rust toolchain, and cache the result for subsequent runs. Once you're ready to upstream this package to the central [pkgx pantry](https://github.com/pkgxdev/pantry), copy `pkgx/projects/github.com/promptexecution/rust-cargo-docs-rag-mcp/package.yml` into a new PR there.
+
 ## Running the Server
 
 There are multiple ways to run the documentation server:

README.md

@@ -4,6 +4,13 @@ install:
 run:
    cargo run --bin cratedocs http --address 0.0.0.0:3000 --debug
 
+install-pkgx:
+   @echo "Using pkgx pantry at {{invocation_directory()}}/pkgx"
+   PKGX_PANTRY_PATH={{invocation_directory()}}/pkgx \
+   PKGX_PANTRY_DIR={{invocation_directory()}}/pkgx \
+   pkgx cratedocs version || \
+      (echo "pkgx failed (likely no network); see README for manual steps" && exit 1)
+
 docker-build:
    docker build -t promptexecution/rust-cargo-docs-rag-mcp .