@mhalder/qdrant-mcp-server 3.0.0 → 3.1.1

package/.github/workflows/ci.yml

@@ -13,7 +13,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [22.x]
+        node-version: [22.x, 24.x]
 
     steps:
       - name: Checkout code
@@ -27,6 +27,9 @@ jobs:
 
       - name: Install dependencies
         run: npm ci
+        env:
+          # Node 24 requires C++20 for native modules
+          CXXFLAGS: ${{ matrix.node-version == '24.x' && '-std=c++20' || '' }}
 
       - name: Type check
         run: npm run type-check

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## <small>3.1.1 (2026-01-22)</small>
+
+* docs: add Node 24 installation instructions ([edb27cc](https://github.com/mhalder/qdrant-mcp-server/commit/edb27cc)), closes [#49](https://github.com/mhalder/qdrant-mcp-server/issues/49)
+
+## 3.1.0 (2026-01-22)
+
+* Merge pull request #48 from mhalder/feat/node-24-support ([d6b57ae](https://github.com/mhalder/qdrant-mcp-server/commit/d6b57ae)), closes [#48](https://github.com/mhalder/qdrant-mcp-server/issues/48)
+* fix(ci): enable C++20 for Node 24 native module builds ([8fca70e](https://github.com/mhalder/qdrant-mcp-server/commit/8fca70e))
+* feat: add Node.js 24 support ([bf39405](https://github.com/mhalder/qdrant-mcp-server/commit/bf39405)), closes [#47](https://github.com/mhalder/qdrant-mcp-server/issues/47)
+
 ## 3.0.0 (2026-01-22)
 
 * feat!(indexer): use git remote URL for consistent collection naming ([f51f82d](https://github.com/mhalder/qdrant-mcp-server/commit/f51f82d))

package/README.md

@@ -25,7 +25,7 @@ A Model Context Protocol (MCP) server providing semantic search capabilities usi
 
 ### Prerequisites
 
-- Node.js 22+
+- Node.js 22.x or 24.x
 - Podman or Docker with Compose support
 
 ### Installation
@@ -34,8 +34,13 @@ A Model Context Protocol (MCP) server providing semantic search capabilities usi
 # Clone and install
 git clone https://github.com/mhalder/qdrant-mcp-server.git
 cd qdrant-mcp-server
+
+# Node 22.x
 npm install
 
+# Node 24.x (requires C++20 flag for native module compilation)
+CXXFLAGS='-std=c++20' npm install
+
 # Start services (choose one)
 podman compose up -d   # Using Podman
 docker compose up -d   # Using Docker
@@ -533,18 +538,18 @@ See [examples/](examples/) directory for detailed guides:
 
 #### Git History Configuration
 
-| Variable                   | Description                                | Default |
-| -------------------------- | ------------------------------------------ | ------- |
-| `GIT_MAX_COMMITS`          | Maximum commits to index per run           | 5000    |
-| `GIT_INCLUDE_FILES`        | Include changed file list in chunks        | true    |
-| `GIT_INCLUDE_DIFF`         | Include truncated diff in chunks           | true    |
-| `GIT_MAX_DIFF_SIZE`        | Maximum diff size in bytes per commit      | 5000    |
-| `GIT_TIMEOUT`              | Timeout for git commands (ms)              | 300000  |
-| `GIT_MAX_CHUNK_SIZE`       | Maximum characters per chunk               | 3000    |
-| `GIT_BATCH_SIZE`           | Number of chunks to embed in one batch     | 100     |
-| `GIT_BATCH_RETRY_ATTEMPTS` | Retry attempts for failed batches          | 3       |
-| `GIT_SEARCH_LIMIT`         | Default search result limit                | 10      |
-| `GIT_ENABLE_HYBRID`        | Enable hybrid search with sparse vectors   | true    |
+| Variable                   | Description                              | Default |
+| -------------------------- | ---------------------------------------- | ------- |
+| `GIT_MAX_COMMITS`          | Maximum commits to index per run         | 5000    |
+| `GIT_INCLUDE_FILES`        | Include changed file list in chunks      | true    |
+| `GIT_INCLUDE_DIFF`         | Include truncated diff in chunks         | true    |
+| `GIT_MAX_DIFF_SIZE`        | Maximum diff size in bytes per commit    | 5000    |
+| `GIT_TIMEOUT`              | Timeout for git commands (ms)            | 300000  |
+| `GIT_MAX_CHUNK_SIZE`       | Maximum characters per chunk             | 3000    |
+| `GIT_BATCH_SIZE`           | Number of chunks to embed in one batch   | 100     |
+| `GIT_BATCH_RETRY_ATTEMPTS` | Retry attempts for failed batches        | 3       |
+| `GIT_SEARCH_LIMIT`         | Default search result limit              | 10      |
+| `GIT_ENABLE_HYBRID`        | Enable hybrid search with sparse vectors | true    |
 
 ### Provider Comparison
 
@@ -577,6 +582,7 @@ See [examples/](examples/) directory for detailed guides:
 | **Files not found**            | Check `.gitignore` and `.contextignore` patterns                                          |
 | **Search returns no results**  | Try broader queries, check if codebase is indexed with `get_index_status`                 |
 | **Out of memory during index** | Reduce `CODE_CHUNK_SIZE` or `CODE_BATCH_SIZE`                                             |
+| **Node 24 tree-sitter error**  | Run `CXXFLAGS='-std=c++20' npm install` - Node 24 requires C++20 for native modules       |
 
 ## Development
 
@@ -596,7 +602,7 @@ npm run test:coverage # Coverage report
 - **Integration Tests**: Code indexer (56), scanner (15), chunker (24), synchronizer (42), snapshot (26), merkle tree (28)
 - **Git History Tests**: Git extractor (28), extractor integration (11), chunker (30), indexer (42), synchronizer (18)
 
-**CI/CD**: GitHub Actions runs build, type-check, and tests on Node.js 22 LTS for every push/PR.
+**CI/CD**: GitHub Actions runs build, type-check, and tests on Node.js 22.x and 24.x for every push/PR.
 
 ## Contributing
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mhalder/qdrant-mcp-server",
-  "version": "3.0.0",
+  "version": "3.1.1",
   "description": "MCP server for semantic search using local Qdrant and Ollama (default) with support for OpenAI, Cohere, and Voyage AI",
   "type": "module",
   "bin": {
@@ -26,7 +26,7 @@
   "author": "mhalder",
   "license": "MIT",
   "engines": {
-    "node": ">=22.0.0 <24.0.0"
+    "node": ">=22.0.0 <25.0.0"
   },
   "repository": {
     "type": "git",