使用说明
mcp服务器qdrant
用于Qdrant的Rust-MCP服务器,带有本地BERT嵌入。单二进制,没有Python。
为什么不呢 官方Python one?
ONNX Python轮在Nix中打包很痛苦(尤其是aarch64-linux)。这是一个使用Nix原生打包和零原生依赖的纯Rust默认后端(Candle)的Rust重写。
用法
克劳德桌面/克劳德代码
随着 uvx (推荐):
{
"mcpServers": {
"qdrant": {
"command": "uvx",
"args": ["mcp-server-qdrant-rs"],
"env": {
"QDRANT_URL": "http://localhost:6334",
"COLLECTION_NAME": "my-collection"
}
}
}
}
随着 瑞维克斯:
{
"mcpServers": {
"qdrant": {
"command": "rvx",
"args": ["mcp-server-qdrant"],
"env": {
"QDRANT_URL": "http://localhost:6334",
"COLLECTION_NAME": "my-collection"
}
}
}
}
Other installation methods
对于Nix:
nix run github:vaporif/mcp-server-qdrant
# ONNX backend
nix run github:vaporif/mcp-server-qdrant#onnx
作为薄片输入:
{
inputs.mcp-server-qdrant.url = "github:vaporif/mcp-server-qdrant";
nixpkgs.overlays = [ mcp-server-qdrant.overlays.default ];
}
货物:
cargo install mcp-server-qdrant
从发布:
从下载预构建的二进制文件 GitHub 发布.
使用Docker:
docker build -t mcp-server-qdrant .
docker run -p 8000:8000 -e QDRANT_URL=http://host.docker.internal:6334 -e COLLECTION_NAME=my-collection mcp-server-qdrant
HTTP传输
mcp-server-qdrant --transport streamable-http --port 8000
调试
RUST_LOG=debug mcp-server-qdrant
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
QDRANT_URL |
-- | Qdrant服务器URL |
QDRANT_API_KEY |
- | Qdrant API密钥 |
QDRANT_LOCAL_PATH |
-- | 本地存储路径(而不是URL) |
COLLECTION_NAME |
-- | 默认集合名称 |
QDRANT_SEARCH_LIMIT |
10 | 最大搜索结果 |
QDRANT_READ_ONLY |
false | 只读模式 |
EMBEDDING_MODEL |
句子转换器/全MiniLM-L6-v2 | 型号名称 |
MCP_TRANSPORT |
站立 | stdio, sse, streamable-http |
HOST |
127.0.0.1 | 绑定SSE/HTTP主机 |
PORT |
8000 | 绑定SSE/HTTP端口 |
嵌入后端
| 特性 | 描述 |
|---|---|
candle (默认) |
纯Rust。没有本地deps。 |
onnx |
ONNX运行时。提供 ORT_DYLIB_PATH. |
onnx-fetch |
具有自动下载功能的ONNX。 |
发展
nix develop # dev shell
just check # clippy + test + fmt + taplo + typos
just test # run tests
just lint # clippy + fmt
just deny # dependency audit
just e2e # e2e tests (needs Qdrant)
许可证
麻省理工学院