From 01b0148c29db9b8ad16e2edfba510d59f4acc12e Mon Sep 17 00:00:00 2001 From: Mohamed Hisham Abdelzaher Date: Tue, 15 Jul 2025 03:24:45 +0300 Subject: [PATCH 1/9] Add Qdrant MCP server configuration. --- servers/qdrant/server.yaml | 116 +++++++++++++++++++++++++++++++++++++ 1 file changed, 116 insertions(+) create mode 100644 servers/qdrant/server.yaml diff --git a/servers/qdrant/server.yaml b/servers/qdrant/server.yaml new file mode 100644 index 0000000..29fe5da --- /dev/null +++ b/servers/qdrant/server.yaml @@ -0,0 +1,116 @@ +name: qdrant +image: mcp/qdrant +type: server +meta: + category: database + tags: + - qdrant + - database +about: + title: Qdrant + description: High-performance, massive-scale Vector Database and Vector Search Engine for the next generation of AI. Also available in the cloud + icon: https://avatars.githubusercontent.com/u/73504361?s=200&v=4 +source: + project: https://github.com/qdrant/mcp-server-qdrant + branch: v0.8.0 +config: + description: Configure the connection to Qdrant, Note: You cannot provide both QDRANT_URL and QDRANT_LOCAL_PATH at the same time. + secrets: + - name: qdrant.api_key + env: QDRANT_API_KEY + example: your-api-key + env: + - name: QDRANT_URL + example: http://localhost:6333 + value: '{{qdrant.qdrant_url}}' + - name: COLLECTION_NAME + example: my-collection + value: '{{qdrant.collection_name}}' + - name: QDRANT_LOCAL_PATH + example: /path/to/qdrant/database + value: '{{qdrant.qdrant_local_path}}' + - name: EMBEDDING_PROVIDER + example: fastembed + value: '{{qdrant.embedding_provider}}' + - name: EMBEDDING_MODEL + example: sentence-transformers/all-MiniLM-L6-v2 + value: '{{qdrant.embedding_model}}' + - name: FASTMCP_DEBUG + example: true + value: '{{qdrant.fastmcp_debug}}' + - name: FASTMCP_LOG_LEVEL + example: INFO + value: '{{qdrant.fastmcp_log_level}}' + - name: FASTMCP_HOST + example: 127.0.0.1 + value: '{{qdrant.fastmcp_host}}' + - name: FASTMCP_PORT + example: 8000 + value: '{{qdrant.fastmcp_port}}' + - name: FASTMCP_WARN_ON_DUPLICATE_RESOURCES + example: true + value: '{{qdrant.fastmcp_warn_on_duplicate_resources}}' + - name: FASTMCP_WARN_ON_DUPLICATE_TOOLS + example: true + value: '{{qdrant.fastmcp_warn_on_duplicate_tools}}' + - name: FASTMCP_WARN_ON_DUPLICATE_PROMPTS + example: true + value: '{{qdrant.fastmcp_warn_on_duplicate_prompts}}' + - name: FASTMCP_DEPENDENCIES + example: [] + value: '{{qdrant.fastmcp_dependencies}}' + parameters: + type: object + properties: + qdrant_url: + type: string + description: URL of the Qdrant server (e.g. https://xyz-example.eu-central.aws.cloud.qdrant.io:6333 for cloud and http://localhost:6333 for self-hosted) + collection_name: + type: string + description: Name of the default collection to use. + qdrant_local_path: + type: string + description: Path to the local Qdrant database (alternative to QDRANT_URL) + embedding_provider: + type: string + description: Embedding provider to use (currently only "fastembed" is supported) + default: fastembed + embedding_model: + type: string + description: Name of the embedding model to use + default: sentence-transformers/all-MiniLM-L6-v2 + fastmcp_debug: + type: boolean + description: Enable debug mode + default: false + fastmcp_log_level: + type: string + description: Set logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL) + default: INFO + fastmcp_host: + type: string + description: Host address to bind the server to + default: 127.0.0.1 + fastmcp_port: + type: integer + description: Port to run the server on + default: 8000 + fastmcp_warn_on_duplicate_resources: + type: boolean + description: Show warnings for duplicate resources + default: true + fastmcp_warn_on_duplicate_tools: + type: boolean + description: Show warnings for duplicate tools + default: true + fastmcp_warn_on_duplicate_prompts: + type: boolean + description: Show warnings for duplicate prompts + default: true + fastmcp_dependencies: + type: array + description: List of dependencies to install in the server environment + items: + type: string + required: + - collection_name From b818037b0c22e93c716bfedd697af634f5a5a24f Mon Sep 17 00:00:00 2001 From: Mohamed Hisham Abdelzaher Date: Tue, 15 Jul 2025 05:42:52 +0300 Subject: [PATCH 2/9] Improve Qdrant server configuration description, logging, and default host. --- servers/qdrant/server.yaml | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/servers/qdrant/server.yaml b/servers/qdrant/server.yaml index 29fe5da..56fe590 100644 --- a/servers/qdrant/server.yaml +++ b/servers/qdrant/server.yaml @@ -14,7 +14,9 @@ source: project: https://github.com/qdrant/mcp-server-qdrant branch: v0.8.0 config: - description: Configure the connection to Qdrant, Note: You cannot provide both QDRANT_URL and QDRANT_LOCAL_PATH at the same time. + description: > + Configure the connection to Qdrant, + Note: You cannot provide both QDRANT_URL and QDRANT_LOCAL_PATH at the same time. secrets: - name: qdrant.api_key env: QDRANT_API_KEY @@ -85,12 +87,13 @@ config: default: false fastmcp_log_level: type: string + enum: [DEBUG, INFO, WARNING, ERROR, CRITICAL] description: Set logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL) default: INFO fastmcp_host: type: string description: Host address to bind the server to - default: 127.0.0.1 + default: 0.0.0.0 fastmcp_port: type: integer description: Port to run the server on From 49ed4a1914d61c2083b1f6804ed72d7d56e7eda4 Mon Sep 17 00:00:00 2001 From: Mohamed Hisham Abdelzaher Date: Tue, 15 Jul 2025 15:45:43 +0300 Subject: [PATCH 3/9] update Qdrant server configuration: update descriptions, use consistent formatting for examples, and adjust defaults. --- servers/qdrant/server.yaml | 42 +++++++++++++++++++------------------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/servers/qdrant/server.yaml b/servers/qdrant/server.yaml index 56fe590..1ee5e6e 100644 --- a/servers/qdrant/server.yaml +++ b/servers/qdrant/server.yaml @@ -8,7 +8,9 @@ meta: - database about: title: Qdrant - description: High-performance, massive-scale Vector Database and Vector Search Engine for the next generation of AI. Also available in the cloud + description: > + High-performance, massive-scale Vector Database and Vector Search Engine for the next generation of AI. + Also available in the cloud icon: https://avatars.githubusercontent.com/u/73504361?s=200&v=4 source: project: https://github.com/qdrant/mcp-server-qdrant @@ -23,50 +25,52 @@ config: example: your-api-key env: - name: QDRANT_URL - example: http://localhost:6333 + example: "http://localhost:6333" value: '{{qdrant.qdrant_url}}' - name: COLLECTION_NAME - example: my-collection + example: "my-collection" value: '{{qdrant.collection_name}}' - name: QDRANT_LOCAL_PATH - example: /path/to/qdrant/database + example: "/path/to/qdrant/database" value: '{{qdrant.qdrant_local_path}}' - name: EMBEDDING_PROVIDER - example: fastembed + example: "fastembed" value: '{{qdrant.embedding_provider}}' - name: EMBEDDING_MODEL - example: sentence-transformers/all-MiniLM-L6-v2 + example: "sentence-transformers/all-MiniLM-L6-v2" value: '{{qdrant.embedding_model}}' - name: FASTMCP_DEBUG - example: true + example: "true" value: '{{qdrant.fastmcp_debug}}' - name: FASTMCP_LOG_LEVEL - example: INFO + example: "INFO" value: '{{qdrant.fastmcp_log_level}}' - name: FASTMCP_HOST - example: 127.0.0.1 - value: '{{qdrant.fastmcp_host}}' + example: "0.0.0.0" + value: "0.0.0.0" - name: FASTMCP_PORT - example: 8000 + example: "8000" value: '{{qdrant.fastmcp_port}}' - name: FASTMCP_WARN_ON_DUPLICATE_RESOURCES - example: true + example: "true" value: '{{qdrant.fastmcp_warn_on_duplicate_resources}}' - name: FASTMCP_WARN_ON_DUPLICATE_TOOLS - example: true + example: "true" value: '{{qdrant.fastmcp_warn_on_duplicate_tools}}' - name: FASTMCP_WARN_ON_DUPLICATE_PROMPTS - example: true + example: "true" value: '{{qdrant.fastmcp_warn_on_duplicate_prompts}}' - name: FASTMCP_DEPENDENCIES - example: [] + example: "[]" value: '{{qdrant.fastmcp_dependencies}}' parameters: type: object properties: qdrant_url: type: string - description: URL of the Qdrant server (e.g. https://xyz-example.eu-central.aws.cloud.qdrant.io:6333 for cloud and http://localhost:6333 for self-hosted) + description: > + URL of the Qdrant server + (e.g. https://xyz-example.eu-central.aws.cloud.qdrant.io:6333 for cloud and http://localhost:6333 for self-hosted) collection_name: type: string description: Name of the default collection to use. @@ -87,13 +91,9 @@ config: default: false fastmcp_log_level: type: string - enum: [DEBUG, INFO, WARNING, ERROR, CRITICAL] + enum: [ DEBUG, INFO, WARNING, ERROR, CRITICAL ] description: Set logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL) default: INFO - fastmcp_host: - type: string - description: Host address to bind the server to - default: 0.0.0.0 fastmcp_port: type: integer description: Port to run the server on From b5ac09a1e79dbca72da9f5fcb58c78bf4b095878 Mon Sep 17 00:00:00 2001 From: Mohamed Hisham Abdelzaher Date: Tue, 15 Jul 2025 22:43:26 +0300 Subject: [PATCH 4/9] Add run command to Qdrant server configuration. --- servers/qdrant/server.yaml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/servers/qdrant/server.yaml b/servers/qdrant/server.yaml index 1ee5e6e..8d768a7 100644 --- a/servers/qdrant/server.yaml +++ b/servers/qdrant/server.yaml @@ -15,6 +15,10 @@ about: source: project: https://github.com/qdrant/mcp-server-qdrant branch: v0.8.0 +run: + command: + - uvx + - mcp-server-qdrant config: description: > Configure the connection to Qdrant, From 3b00c22306fe7f3d7ae94615636962b15290be4a Mon Sep 17 00:00:00 2001 From: Mohamed Hisham Abdelzaher Date: Mon, 21 Jul 2025 04:34:25 +0300 Subject: [PATCH 5/9] Update Qdrant server configuration: add volume for fastembed model, remove unused fastmcp_host/port settings, and include FASTEMBED_CACHE_PATH. --- servers/qdrant/server.yaml | 15 +++++---------- 1 file changed, 5 insertions(+), 10 deletions(-) diff --git a/servers/qdrant/server.yaml b/servers/qdrant/server.yaml index 8d768a7..4a3ebf7 100644 --- a/servers/qdrant/server.yaml +++ b/servers/qdrant/server.yaml @@ -19,6 +19,8 @@ run: command: - uvx - mcp-server-qdrant + volumes: + - fastembed_model:$FASTEMBED_CACHE_PATH config: description: > Configure the connection to Qdrant, @@ -49,12 +51,6 @@ config: - name: FASTMCP_LOG_LEVEL example: "INFO" value: '{{qdrant.fastmcp_log_level}}' - - name: FASTMCP_HOST - example: "0.0.0.0" - value: "0.0.0.0" - - name: FASTMCP_PORT - example: "8000" - value: '{{qdrant.fastmcp_port}}' - name: FASTMCP_WARN_ON_DUPLICATE_RESOURCES example: "true" value: '{{qdrant.fastmcp_warn_on_duplicate_resources}}' @@ -67,6 +63,9 @@ config: - name: FASTMCP_DEPENDENCIES example: "[]" value: '{{qdrant.fastmcp_dependencies}}' + - name: FASTEMBED_CACHE_PATH + example: "/hf" + value: "/hf" parameters: type: object properties: @@ -98,10 +97,6 @@ config: enum: [ DEBUG, INFO, WARNING, ERROR, CRITICAL ] description: Set logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL) default: INFO - fastmcp_port: - type: integer - description: Port to run the server on - default: 8000 fastmcp_warn_on_duplicate_resources: type: boolean description: Show warnings for duplicate resources From 5406f6f69b13391d1bb510865ba4e8e2b2a0b78c Mon Sep 17 00:00:00 2001 From: Mohamed Hisham Abdelzaher Date: Thu, 24 Jul 2025 23:24:58 +0300 Subject: [PATCH 6/9] Update Qdrant server configuration: adjust volume path for fastembed model, use consistent formatting for examples, and revise default values. --- servers/qdrant/server.yaml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/servers/qdrant/server.yaml b/servers/qdrant/server.yaml index 4a3ebf7..e637f97 100644 --- a/servers/qdrant/server.yaml +++ b/servers/qdrant/server.yaml @@ -20,7 +20,7 @@ run: - uvx - mcp-server-qdrant volumes: - - fastembed_model:$FASTEMBED_CACHE_PATH + - fastembed_model:/hf config: description: > Configure the connection to Qdrant, @@ -34,10 +34,10 @@ config: example: "http://localhost:6333" value: '{{qdrant.qdrant_url}}' - name: COLLECTION_NAME - example: "my-collection" + example: my-collection value: '{{qdrant.collection_name}}' - name: QDRANT_LOCAL_PATH - example: "/path/to/qdrant/database" + example: '' value: '{{qdrant.qdrant_local_path}}' - name: EMBEDDING_PROVIDER example: "fastembed" @@ -64,8 +64,8 @@ config: example: "[]" value: '{{qdrant.fastmcp_dependencies}}' - name: FASTEMBED_CACHE_PATH - example: "/hf" - value: "/hf" + example: /hf + value: /hf parameters: type: object properties: From 06e167733b6f1039ff90f99fda4916728e944166 Mon Sep 17 00:00:00 2001 From: Mohamed Hisham Abdelzaher Date: Thu, 24 Jul 2025 23:30:40 +0300 Subject: [PATCH 7/9] Update Qdrant server configuration: standardize example formatting for environment variables. --- servers/qdrant/server.yaml | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/servers/qdrant/server.yaml b/servers/qdrant/server.yaml index e637f97..773a216 100644 --- a/servers/qdrant/server.yaml +++ b/servers/qdrant/server.yaml @@ -31,7 +31,7 @@ config: example: your-api-key env: - name: QDRANT_URL - example: "http://localhost:6333" + example: http://localhost:6333 value: '{{qdrant.qdrant_url}}' - name: COLLECTION_NAME example: my-collection @@ -40,28 +40,28 @@ config: example: '' value: '{{qdrant.qdrant_local_path}}' - name: EMBEDDING_PROVIDER - example: "fastembed" + example: fastembed value: '{{qdrant.embedding_provider}}' - name: EMBEDDING_MODEL - example: "sentence-transformers/all-MiniLM-L6-v2" + example: sentence-transformers/all-MiniLM-L6-v2 value: '{{qdrant.embedding_model}}' - name: FASTMCP_DEBUG - example: "true" + example: true value: '{{qdrant.fastmcp_debug}}' - name: FASTMCP_LOG_LEVEL - example: "INFO" + example: INFO value: '{{qdrant.fastmcp_log_level}}' - name: FASTMCP_WARN_ON_DUPLICATE_RESOURCES - example: "true" + example: true value: '{{qdrant.fastmcp_warn_on_duplicate_resources}}' - name: FASTMCP_WARN_ON_DUPLICATE_TOOLS - example: "true" + example: true value: '{{qdrant.fastmcp_warn_on_duplicate_tools}}' - name: FASTMCP_WARN_ON_DUPLICATE_PROMPTS - example: "true" + example: true value: '{{qdrant.fastmcp_warn_on_duplicate_prompts}}' - name: FASTMCP_DEPENDENCIES - example: "[]" + example: [ ] value: '{{qdrant.fastmcp_dependencies}}' - name: FASTEMBED_CACHE_PATH example: /hf From 692e8ac30a8ea03ff5d4d5ce9e95c4b189655ac9 Mon Sep 17 00:00:00 2001 From: Mohamed Hisham Abdelzaher Date: Thu, 24 Jul 2025 23:31:38 +0300 Subject: [PATCH 8/9] Update Qdrant server configuration: ensure consistent string formatting for example values. --- servers/qdrant/server.yaml | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/servers/qdrant/server.yaml b/servers/qdrant/server.yaml index 773a216..f0043ac 100644 --- a/servers/qdrant/server.yaml +++ b/servers/qdrant/server.yaml @@ -31,40 +31,40 @@ config: example: your-api-key env: - name: QDRANT_URL - example: http://localhost:6333 + example: 'http://localhost:6333' value: '{{qdrant.qdrant_url}}' - name: COLLECTION_NAME - example: my-collection + example: 'my-collection' value: '{{qdrant.collection_name}}' - name: QDRANT_LOCAL_PATH example: '' value: '{{qdrant.qdrant_local_path}}' - name: EMBEDDING_PROVIDER - example: fastembed + example: 'fastembed' value: '{{qdrant.embedding_provider}}' - name: EMBEDDING_MODEL - example: sentence-transformers/all-MiniLM-L6-v2 + example: 'sentence-transformers/all-MiniLM-L6-v2' value: '{{qdrant.embedding_model}}' - name: FASTMCP_DEBUG - example: true + example: 'true' value: '{{qdrant.fastmcp_debug}}' - name: FASTMCP_LOG_LEVEL - example: INFO + example: 'INFO' value: '{{qdrant.fastmcp_log_level}}' - name: FASTMCP_WARN_ON_DUPLICATE_RESOURCES - example: true + example: 'true' value: '{{qdrant.fastmcp_warn_on_duplicate_resources}}' - name: FASTMCP_WARN_ON_DUPLICATE_TOOLS - example: true + example: 'true' value: '{{qdrant.fastmcp_warn_on_duplicate_tools}}' - name: FASTMCP_WARN_ON_DUPLICATE_PROMPTS - example: true + example: 'true' value: '{{qdrant.fastmcp_warn_on_duplicate_prompts}}' - name: FASTMCP_DEPENDENCIES - example: [ ] + example: '[]' value: '{{qdrant.fastmcp_dependencies}}' - name: FASTEMBED_CACHE_PATH - example: /hf + example: '/hf' value: /hf parameters: type: object From c39bdd443f1bed44d264c9957abc9327324bd7fd Mon Sep 17 00:00:00 2001 From: Mohamed Hisham Abdelzaher Date: Fri, 25 Jul 2025 23:09:51 +0300 Subject: [PATCH 9/9] Update Qdrant server configuration: set 'None' as the example value for QDRANT_LOCAL_PATH. --- servers/qdrant/server.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/servers/qdrant/server.yaml b/servers/qdrant/server.yaml index f0043ac..9ede6f6 100644 --- a/servers/qdrant/server.yaml +++ b/servers/qdrant/server.yaml @@ -37,7 +37,7 @@ config: example: 'my-collection' value: '{{qdrant.collection_name}}' - name: QDRANT_LOCAL_PATH - example: '' + example: 'None' value: '{{qdrant.qdrant_local_path}}' - name: EMBEDDING_PROVIDER example: 'fastembed'