@mhalder/qdrant-mcp-server 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## 1.4.0 (2025-10-13)
+
+* Merge pull request #29 from mhalder/feature/configurable-prompts ([f9652b1](https://github.com/mhalder/qdrant-mcp-server/commit/f9652b1)), closes [#29](https://github.com/mhalder/qdrant-mcp-server/issues/29)
+* feat: add support for configurable MCP prompts ([e3cc6c2](https://github.com/mhalder/qdrant-mcp-server/commit/e3cc6c2)), closes [#28](https://github.com/mhalder/qdrant-mcp-server/issues/28)
+* feat: set default prompts.json path with auto-loading ([203694a](https://github.com/mhalder/qdrant-mcp-server/commit/203694a))
+* test: add comprehensive tests for prompts feature ([bb9ca66](https://github.com/mhalder/qdrant-mcp-server/commit/bb9ca66))
+
+## <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)

package/README.md

@@ -12,6 +12,7 @@ A Model Context Protocol (MCP) server providing semantic search capabilities usi
 - **Multiple Providers**: Ollama (default), OpenAI, Cohere, and Voyage AI
 - **Hybrid Search**: Combine semantic and keyword search for better results
 - **Semantic Search**: Natural language search with metadata filtering
+- **Configurable Prompts**: Create custom prompts for guided workflows without code changes
 - **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
@@ -128,6 +129,72 @@ See [Advanced Configuration](#advanced-configuration) section below for all opti
 - `qdrant://collections` - List all collections
 - `qdrant://collection/{name}` - Collection details
 
+## Configurable Prompts
+
+Create custom prompts tailored to your specific use cases without modifying code. Prompts provide guided workflows for common tasks.
+
+**Note**: By default, the server looks for `prompts.json` in the project root directory. If the file exists, prompts are automatically loaded. You can specify a custom path using the `PROMPTS_CONFIG_FILE` environment variable.
+
+### Setup
+
+1. **Create a prompts configuration file** (e.g., `prompts.json` in the project root):
+
+   See [`prompts.example.json`](prompts.example.json) for example configurations you can copy and customize.
+
+2. **Configure the server** (optional - only needed for custom path):
+
+If you place `prompts.json` in the project root, no additional configuration is needed. To use a custom path:
+
+```json
+{
+  "mcpServers": {
+    "qdrant": {
+      "command": "node",
+      "args": ["/path/to/qdrant-mcp-server/build/index.js"],
+      "env": {
+        "QDRANT_URL": "http://localhost:6333",
+        "PROMPTS_CONFIG_FILE": "/custom/path/to/prompts.json"
+      }
+    }
+  }
+}
+```
+
+3. **Use prompts** in your AI assistant:
+
+**Claude Code:**
+
+```bash
+/mcp__qdrant__find_similar_docs papers "neural networks" 10
+```
+
+**VSCode:**
+
+```bash
+/mcp.qdrant.find_similar_docs papers "neural networks" 10
+```
+
+### Example Prompts
+
+See [`prompts.example.json`](prompts.example.json) for ready-to-use prompts including:
+
+- `find_similar_docs` - Semantic search with result explanation
+- `setup_rag_collection` - Create RAG-optimized collections
+- `analyze_collection` - Collection insights and recommendations
+- `bulk_add_documents` - Guided bulk document insertion
+- `search_with_filter` - Metadata filtering assistance
+- `compare_search_methods` - Semantic vs hybrid search comparison
+- `collection_maintenance` - Maintenance and cleanup workflows
+- `migrate_to_hybrid` - Collection migration guide
+
+### Template Syntax
+
+Templates use `{{variable}}` placeholders:
+
+- Required arguments must be provided
+- Optional arguments use defaults if not specified
+- Unknown variables are left as-is in the output
+
 ## Examples
 
 See [examples/](examples/) directory for detailed guides:
@@ -147,6 +214,7 @@ See [examples/](examples/) directory for detailed guides:
 | `HTTP_PORT`                         | Port for HTTP transport                | 3000                  |
 | `EMBEDDING_PROVIDER`                | "ollama", "openai", "cohere", "voyage" | ollama                |
 | `QDRANT_URL`                        | Qdrant server URL                      | http://localhost:6333 |
+| `PROMPTS_CONFIG_FILE`               | Path to prompts configuration JSON     | prompts.json          |
 | `EMBEDDING_MODEL`                   | Model name                             | Provider-specific     |
 | `EMBEDDING_BASE_URL`                | Custom API URL                         | Provider-specific     |
 | `EMBEDDING_MAX_REQUESTS_PER_MINUTE` | Rate limit                             | Provider-specific     |