@mhalder/qdrant-mcp-server 1.2.0 → 1.3.1

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+## <small>1.3.1 (2025-10-12)</small>
+
+* Merge pull request #27 from mhalder/fix/empty-responses ([30d33a7](https://github.com/mhalder/qdrant-mcp-server/commit/30d33a7)), closes [#27](https://github.com/mhalder/qdrant-mcp-server/issues/27)
+* fix: improve HTTP transport robustness and prevent resource leaks ([cff1248](https://github.com/mhalder/qdrant-mcp-server/commit/cff1248)), closes [#26](https://github.com/mhalder/qdrant-mcp-server/issues/26)
+
+## 1.3.0 (2025-10-11)
+
+* Merge pull request #25 from mhalder/feature/http-transport ([efc90c3](https://github.com/mhalder/qdrant-mcp-server/commit/efc90c3)), closes [#25](https://github.com/mhalder/qdrant-mcp-server/issues/25)
+* fix: address PR feedback for HTTP transport implementation ([1aec6d5](https://github.com/mhalder/qdrant-mcp-server/commit/1aec6d5))
+* fix: address PR feedback for HTTP transport implementation ([3243d0e](https://github.com/mhalder/qdrant-mcp-server/commit/3243d0e))
+* fix: clear cleanup interval on shutdown and improve error messages ([6aa29f3](https://github.com/mhalder/qdrant-mcp-server/commit/6aa29f3))
+* fix: implement per-IP rate limiting and consolidate port validation ([c3bfc92](https://github.com/mhalder/qdrant-mcp-server/commit/c3bfc92))
+* fix: prevent transport double closure and add rate limiter memory management ([2f92d78](https://github.com/mhalder/qdrant-mcp-server/commit/2f92d78))
+* fix: resolve critical issues in HTTP transport implementation ([7951f2b](https://github.com/mhalder/qdrant-mcp-server/commit/7951f2b))
+* fix: resolve race condition and resource leak in HTTP timeout handler ([6635ccb](https://github.com/mhalder/qdrant-mcp-server/commit/6635ccb))
+* docs: add Try It and Cleanup sections to hybrid-search example ([5e32f16](https://github.com/mhalder/qdrant-mcp-server/commit/5e32f16))
+* feat: add HTTP transport support for remote MCP server deployment ([983a9d6](https://github.com/mhalder/qdrant-mcp-server/commit/983a9d6)), closes [#24](https://github.com/mhalder/qdrant-mcp-server/issues/24)
+
 ## 1.2.0 (2025-10-11)
 
 * Merge pull request #23 from mhalder/feature/hybrid-search ([5925df7](https://github.com/mhalder/qdrant-mcp-server/commit/5925df7)), closes [#23](https://github.com/mhalder/qdrant-mcp-server/issues/23)

package/README.md

@@ -14,6 +14,7 @@ A Model Context Protocol (MCP) server providing semantic search capabilities usi
 - **Semantic Search**: Natural language search with metadata filtering
 - **Rate Limiting**: Intelligent throttling with exponential backoff
 - **Full CRUD**: Create, search, and manage collections and documents
+- **Flexible Deployment**: Run locally (stdio) or as a remote HTTP server
 
 ## Quick Start
 
@@ -40,6 +41,8 @@ npm run build
 
 ### Configuration
 
+#### Local Setup (stdio transport)
+
 Add to `~/.claude/claude_code_config.json`:
 
 ```json
@@ -57,6 +60,35 @@ Add to `~/.claude/claude_code_config.json`:
 }
 ```
 
+#### Remote Setup (HTTP transport)
+
+> **⚠️ Security Warning**: When deploying the HTTP transport in production:
+>
+> - **Always** run behind a reverse proxy (nginx, Caddy) with HTTPS
+> - Implement authentication/authorization at the proxy level
+> - Use firewalls to restrict access to trusted networks
+> - Never expose directly to the public internet without protection
+> - Consider implementing rate limiting at the proxy level
+> - Monitor server logs for suspicious activity
+
+**Start the server:**
+
+```bash
+TRANSPORT_MODE=http HTTP_PORT=3000 node build/index.js
+```
+
+**Configure client:**
+
+```json
+{
+  "mcpServers": {
+    "qdrant": {
+      "url": "http://your-server:3000/mcp"
+    }
+  }
+}
+```
+
 **Using a different provider:**
 
 ```json
@@ -111,6 +143,8 @@ See [examples/](examples/) directory for detailed guides:
 
 | Variable                            | Description                            | Default               |
 | ----------------------------------- | -------------------------------------- | --------------------- |
+| `TRANSPORT_MODE`                    | "stdio" or "http"                      | stdio                 |
+| `HTTP_PORT`                         | Port for HTTP transport                | 3000                  |
 | `EMBEDDING_PROVIDER`                | "ollama", "openai", "cohere", "voyage" | ollama                |
 | `QDRANT_URL`                        | Qdrant server URL                      | http://localhost:6333 |
 | `EMBEDDING_MODEL`                   | Model name                             | Provider-specific     |