Merge pull request #12 from qdrant/feature/embedding-providers

Abstract the embedding providers
This commit is contained in:
Kacper Łukawski
2025-03-05 23:10:05 +01:00
committed by GitHub
11 changed files with 200 additions and 29 deletions

View File

@@ -38,7 +38,7 @@ uv run mcp-server-qdrant \
--qdrant-url "http://localhost:6333" \
--qdrant-api-key "your_api_key" \
--collection-name "my_collection" \
--fastembed-model-name "sentence-transformers/all-MiniLM-L6-v2"
--embedding-model "sentence-transformers/all-MiniLM-L6-v2"
```
### Installing via Smithery
@@ -78,7 +78,7 @@ This MCP server will automatically create a collection with the specified name i
By default, the server will use the `sentence-transformers/all-MiniLM-L6-v2` embedding model to encode memories.
For the time being, only [FastEmbed](https://qdrant.github.io/fastembed/) models are supported, and you can change it
by passing the `--fastembed-model-name` argument to the server.
by passing the `--embedding-model` argument to the server.
### Using the local mode of Qdrant
@@ -108,11 +108,31 @@ The configuration of the server can be also done using environment variables:
- `QDRANT_URL`: URL of the Qdrant server, e.g. `http://localhost:6333`
- `QDRANT_API_KEY`: API key for the Qdrant server
- `COLLECTION_NAME`: Name of the collection to use
- `FASTEMBED_MODEL_NAME`: Name of the FastEmbed model to use
- `EMBEDDING_MODEL`: Name of the embedding model to use
- `EMBEDDING_PROVIDER`: Embedding provider to use (currently only "fastembed" is supported)
- `QDRANT_LOCAL_PATH`: Path to the local Qdrant database
You cannot provide `QDRANT_URL` and `QDRANT_LOCAL_PATH` at the same time.
## Contributing
If you have suggestions for how mcp-server-qdrant could be improved, or want to report a bug, open an issue!
We'd love all and any contributions.
### Testing `mcp-server-qdrant` locally
The [MCP inspector](https://github.com/modelcontextprotocol/inspector) is a developer tool for testing and debugging MCP
servers. It runs both a client UI (default port 5173) and an MCP proxy server (default port 3000). Open the client UI in
your browser to use the inspector.
```shell
npx @modelcontextprotocol/inspector uv run mcp-server-qdrant \
--collection-name test \
--qdrant-local-path /tmp/qdrant-local-test
```
Once started, open your browser to http://localhost:5173 to access the inspector interface.
## License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software,