ci: refactor build workflow and add docsearch integration

Author: zhensherlock

.github/actions/setup-pnpm/action.yml

@@ -0,0 +1,43 @@
+name: "Setup Node with PNPM"
+description: "Checkout, setup Node, configure PNPM and install dependencies"
+
+inputs:
+  node-version:
+    description: "Node.js version"
+    required: true
+    default: "22"
+
+    pnpm-version:
+      description: "PNPM version"
+      required: false
+      default: "latest"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Install Node
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ inputs.node-version }}
+        cache: 'pnpm'
+
+    - name: Install PNPM
+      run: npm i pnpm@latest -g
+      shell: bash
+
+    - name: Setup npmrc
+      run: echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > .npmrc
+      shell: bash
+
+    - name: Setup pnpm config
+      run: pnpm config set store-dir $PNPM_CACHE_FOLDER
+      shell: bash
+
+    - name: Install Package
+      run: pnpm install
+      shell: bash

.github/workflows/build.yml

@@ -12,30 +12,26 @@ jobs:
     if: github.repository == 'my-mcp-hub/mcp-kit'
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Install Node
-        uses: actions/setup-node@v4
+      - uses: ./.github/actions/setup-pnpm
         with:
           node-version: 22
 
-      - name: Install PNPM
-        run: npm i pnpm@latest -g
-
-      - name: Setup npmrc
-        run: echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > .npmrc
+      - name: Build Package
+        run: pnpm run build
 
-      - name: setup pnpm config
-        run: pnpm config set store-dir $PNPM_CACHE_FOLDER
+      - name: Test Package
+        run: pnpm run coverage
 
-      - name: Install Package
-        run: pnpm install
+      - name: Coveralls
+        uses: coverallsapp/github-action@v2
 
-      - name: Build Package
-        run: pnpm run build
+  doc:
+    if: github.repository == 'my-mcp-hub/mcp-kit'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: ./.github/actions/setup-pnpm
+        with:
+          node-version: 22
 
       - name: Build Docs Package
         run: pnpm run docs:build
@@ -46,8 +42,12 @@ jobs:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: docs/.vitepress/dist
 
-      - name: Test Package
-        run: pnpm run coverage
-
-      - name: Coveralls
-        uses: coverallsapp/github-action@v2
+      - name: Get the content of algolia.json as config
+        id: algolia_config
+        run: echo "config=$(cat docs/crawlerConfig.json | jq -r tostring)" >> $GITHUB_OUTPUT
+      - name: Push indices to Algolia
+        uses: signcl/docsearch-scraper-action@master
+        env:
+          APPLICATION_ID: ${{ secrets.ALGOLIA_APPLICATION_ID }}
+          API_KEY: ${{ secrets.ALGOLIA_API_KEY }}
+          CONFIG: ${{ steps.algolia_config.outputs.config }}

docs/crawlerConfig.json

@@ -0,0 +1,33 @@
+{
+  "index_name": "create-mcp-kit",
+  "start_urls": ["https://my-mcp-hub.github.io/mcp-kit/"],
+  "rateLimit": 8,
+  "maxDepth": 10,
+  "selectors": {
+    "lvl0": {
+      "selector": "",
+      "defaultValue": "Documentation"
+    },
+    "lvl1": ".content h1",
+    "lvl2": ".content h2",
+    "lvl3": ".content h3",
+    "lvl4": ".content h4",
+    "lvl5": ".content h5",
+    "content": ".content p, .content li",
+    "lang": {
+      "selector": "/html/@lang",
+      "type": "xpath",
+      "global": true
+    }
+  },
+  "selectors_exclude": [
+    "aside",
+    ".page-footer",
+    ".next-and-prev-link",
+    ".table-of-contents"
+  ],
+  "custom_settings": {
+    "attributesForFaceting": ["lang", "tags"]
+  },
+  "js_render": true
+}