Add pkgx support with package.yml configuration

Co-authored-by: elasticdotventures <[email protected]>

Author: Copilot

README.md

@@ -10,13 +10,32 @@
 
 ## Installation
 
+### Using Cargo (Standard)
+
 ```bash
 git clone https://github.com/promptexecution/rust-cargo-docs-rag-mcp.git
 cd rust-cargo-docs-rag-mcp
 cargo build --release
 cargo install --path .
 ```
 
+### Using pkgx
+
+[pkgx](https://pkgx.dev) is a universal package manager that can build and run this project without requiring a system-wide Rust installation:
+
+```bash
+# Install using pkgx (automatically handles Rust dependencies)
+pkgx install
+
+# Or build directly with pkgx
+pkgx +rust +cargo cargo build --release
+
+# Run without installing
+pkgx +rust +cargo cargo run --bin cratedocs -- stdio
+```
+
+The project includes a `package.yml` file for pkgx integration, making it easy to build and test across different environments.
+
 ## Running the Server
 
 There are multiple ways to run the documentation server:

justfile

@@ -1,6 +1,18 @@
 install:
    cargo install --git https://github.com/promptexecution/rust-cargo-docs-rag-mcp --locked
 
+# Build with pkgx (ensures correct Rust version and dependencies)
+pkgx-build:
+   pkgx +rust +cargo cargo build --release
+
+# Run with pkgx
+pkgx-run:
+   pkgx +rust +cargo cargo run --bin cratedocs http --address 0.0.0.0:3000 --debug
+
+# Test with pkgx
+pkgx-test:
+   pkgx +rust +cargo cargo test
+
 run:
    cargo run --bin cratedocs http --address 0.0.0.0:3000 --debug
 

package.yml

@@ -0,0 +1,21 @@
+distributable:
+  url: https://github.com/PromptExecution/rust-cargo-docs-rag-mcp/archive/refs/tags/v{{version}}.tar.gz
+  strip-components: 1
+
+provides:
+  - bin/cratedocs
+
+versions:
+  github: PromptExecution/rust-cargo-docs-rag-mcp/tags
+
+build:
+  dependencies:
+    rust-lang.org: '>=1.70'
+    rust-lang.org/cargo: '*'
+  script: |
+    cargo install --path . --root {{prefix}}
+
+test:
+  script: |
+    cratedocs version
+    cratedocs test --tool help