Qdrant MCP Server 是什么?
Qdrant MCP Server 是连接 Qdrant 向量数据库的语义检索工具。Codex 可以把允许保存的文本写入指定集合,并按含义召回相关片段和来源元数据。
为什么需要它?
让助手从指定向量集合检索相关片段,而不是把整个知识库一次性塞入上下文。
接入前,AI 只能依赖你粘贴的材料、截图或旧上下文;接入后,它可以在你授权的范围内调用真实工具,并把结果、来源和状态带回当前任务。
核心能力
适合谁?怎么用?
- 在指定向量集合中检索知识片段
- 已经使用 Qdrant,希望为项目资料或代码建立可限定集合的语义检索。
- 集合与实际返回片段的来源字段可核对;本MCP的查询/存储工具不等于提供删除功能,清理测试数据须使用Qdrant本身的管理接口。
- 不适合把客户隐私或未授权文档批量写入长期知识库。
- 向量库可能长期保存内部文本与代码
- 检索结果可能跨用户或项目泄露
怎么接入?
- 1准备
准备已运行的测试 Qdrant 和可核对的 docs-test 测试片段;先安装 uv/uvx。
- 2授权
按下方命令配置 QDRANT_URL、COLLECTION_NAME 和 QDRANT_READ_ONLY。
- 3连接
托管实例的 QDRANT_API_KEY 通过客户端 env_vars 转发;本机无认证测试例不需要该值。
- 4开始使用
重新打开任务后调用 qdrant-find;空集合返回无匹配不能证明召回质量。
添加 Qdrant MCP Server
codex mcp add qdrant --env QDRANT_URL=http://127.0.0.1:6333 --env COLLECTION_NAME=docs-test --env QDRANT_READ_ONLY=true -- uvx mcp-server-qdrant适用于已运行在本机 6333 端口的测试 Qdrant,需先安装 uv/uvx;本页没有启动数据库。COLLECTION_NAME 固定集合;QDRANT_READ_ONLY=true 隐藏存储工具。先由数据负责人提供测试片段,否则空集合无法检验召回质量。托管实例还需 QDRANT_API_KEY,含密钥时在客户端配置 env_vars 转发而不写进命令;QDRANT_LOCAL_PATH 是本地存储替代项,不能与 QDRANT_URL 同设。本轮未安装运行。
确认 MCP 已经登记
codex mcp list不想自己操作终端时,把下面整段发给 Codex。它会先核对官方说明和前置条件,遇到凭证或占位符会停下来询问。
自助接入 Qdrant MCP Server
请帮我在当前电脑上接入并验证 Qdrant MCP Server。
官方来源:https://github.com/qdrant/mcp-server-qdrant
目标接入命令:codex mcp add qdrant --env QDRANT_URL=http://127.0.0.1:6333 --env COLLECTION_NAME=docs-test --env QDRANT_READ_ONLY=true -- uvx mcp-server-qdrant
请按以下步骤执行:
1. 先阅读官方 README,核对当前推荐接入方式与上述命令。如果官方说明已经变化,先告诉我差异,不要盲目执行旧命令。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证,也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符,先列出需要我提供的值并停下来,不要自行猜测。
4. 条件满足后执行接入命令,再运行 codex mcp list,确认 Qdrant MCP Server 已登记,并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接:请用 Qdrant MCP 在 docs-test 集合中检索 5 个与登录排错相关的片段,并返回每条的来源元数据。
6. 不要创建、修改、删除、发送内容,也不要连接生产环境;需要写权限或更高权限时先征求我确认。- 复制完整指令,发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境;遇到 Token、项目 ID、路径或其他占位符时,应停下来向你确认。
- 接入后运行
codex mcp list,再用 Qdrant MCP Server 的小范围测试任务回读结果。
第一次调用示例
登记完成后,新开一个任务,按下面任务限定调用范围,先说清目标、范围和停止条件。
第一次小范围任务
请用 Qdrant MCP 在 docs-test 集合中检索 5 个与登录排错相关的片段,并返回每条的来源元数据。集合与实际返回片段的来源字段可核对;本MCP的查询/存储工具不等于提供删除功能,清理测试数据须使用Qdrant本身的管理接口。
- 先定义集合用途和元数据字段。
- 只写入允许长期保存的内容。
- 用已知问题测试召回并检查来源元数据。
- 删除测试条目,确认数据生命周期可控。
权限与安全
本地 stdio 或 HTTP;固定集合、地址和受限 API Key,先用测试数据。
- 向量库可能长期保存内部文本与代码
- 检索结果可能跨用户或项目泄露
- 需要集合隔离、最小 Key、删除机制和嵌入数据审查
