feat: add crates.io publish workflow and cargo installation docs (#81)

* fix: improve error handling and avoid the panic

* feat: publish to crates.io

* chore: update cargo toml

Author: hashemix

.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: Publish to Crates.io
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Cache Rust
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.rustup/toolchains
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-rust-${{ steps.toolchain.outputs.cachekey }}
+          restore-keys: ${{ runner.os }}-rust-
+
+      - name: Install Rust Toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Publish to Crates.io
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+        run: cargo publish --token $CARGO_REGISTRY_TOKEN

Cargo.toml

@@ -4,9 +4,17 @@ version = "0.4.0"
 edition = "2024"
 repository = "https://github.com/rust-mcp-stack/rust-mcp-filesystem"
 authors = ["Ali Hashemi"]
+categories = ["command-line-interface", "command-line-utilities"]
 description = "Blazing-fast, asynchronous MCP server for seamless filesystem operations."
 homepage = "https://github.com/rust-mcp-stack/rust-mcp-filesystem"
-
+keywords = [
+    "filesystem mcp server in rust",
+    "rust-mcp-stack",
+    "mcp filesystem",
+    "rust-mcp-filesystem",
+]
+homepage = "https://rust-mcp-stack.github.io/rust-mcp-filesystem"
+license = "MIT"
 
 [package.metadata.wix]
 upgrade-guid = "944FE3C9-C8C2-4114-8C8F-5330720E781F"

README.md

@@ -47,6 +47,11 @@ powershell -ExecutionPolicy Bypass -c "irm https://github.com/rust-mcp-stack/rus
 brew install rust-mcp-stack/tap/rust-mcp-filesystem
 ```
 
+#### **Cargo**
+
+```sh
+cargo install rust-mcp-filesystem --locked
+```
 
 - **NPM**
 

docs/README.md

@@ -40,6 +40,12 @@ powershell -ExecutionPolicy Bypass -c "irm https://github.com/rust-mcp-stack/rus
 brew install rust-mcp-stack/tap/rust-mcp-filesystem
 ```
 
+#### **Cargo**
+
+```sh
+cargo install rust-mcp-filesystem --locked
+```
+
 ##### **NPM**
 
 ```sh

docs/guide/install.md

@@ -18,6 +18,19 @@ powershell -ExecutionPolicy Bypass -c "irm https://github.com/rust-mcp-stack/rus
 
 <!-- x-release-please-end -->
 
+#### **Cargo**
+
+```sh
+cargo install rust-mcp-filesystem --locked
+```
+
+##### **NPM**
+
+```sh
+npm i -g @rustmcp/rust-mcp-filesystem@latest
+```
+> The npm package is provided for convenience. It runs the same underlying Rust binary but can be installed and used as a standard npm package.
+
 #### **Homebrew**
 
 ```sh

docs/quickstart.md

@@ -18,6 +18,20 @@ powershell -ExecutionPolicy Bypass -c "irm https://github.com/rust-mcp-stack/rus
 
 <!-- x-release-please-end -->
 
+#### **Cargo**
+
+```sh
+cargo install rust-mcp-filesystem --locked
+```
+
+##### **NPM**
+
+```sh
+npm i -g @rustmcp/rust-mcp-filesystem@latest
+```
+> The npm package is provided for convenience. It runs the same underlying Rust binary but can be installed and used as a standard npm package.
+
+
 #### **Homebrew**
 
 ```sh