数据库 · Qdrant 官方仓库

Qdrant MCP Server

把文档或代码片段写入 Qdrant 并进行语义检索,适合受控知识库与代码搜索。

CodexClaude CodestdioHTTP

Qdrant MCP Server 是什么?

Qdrant MCP Server 是连接 Qdrant 向量数据库的语义检索工具。Codex 可以把允许保存的文本写入指定集合,并按含义召回相关片段和来源元数据。

一句话理解把文档或代码片段写入 Qdrant 并进行语义检索,适合受控知识库与代码搜索。

为什么需要它?

让助手从指定向量集合检索相关片段,而不是把整个知识库一次性塞入上下文。

接入前,AI 只能依赖你粘贴的材料、截图或旧上下文;接入后,它可以在你授权的范围内调用真实工具,并把结果、来源和状态带回当前任务。

核心能力

01
向指定集合写入带元数据的条目
02
执行语义相似度检索
03
连接本地或 Qdrant Cloud 实例

适合谁?怎么用?

适合使用
  • 在指定向量集合中检索知识片段
  • 已经使用 Qdrant,希望为项目资料或代码建立可限定集合的语义检索。
  • 集合与实际返回片段的来源字段可核对;本MCP的查询/存储工具不等于提供删除功能,清理测试数据须使用Qdrant本身的管理接口。
不适合
  • 不适合把客户隐私或未授权文档批量写入长期知识库。
  • 向量库可能长期保存内部文本与代码
  • 检索结果可能跨用户或项目泄露

怎么接入?

  1. 1
    准备

    准备已运行的测试 Qdrant 和可核对的 docs-test 测试片段;先安装 uv/uvx。

  2. 2
    授权

    按下方命令配置 QDRANT_URL、COLLECTION_NAME 和 QDRANT_READ_ONLY。

  3. 3
    连接

    托管实例的 QDRANT_API_KEY 通过客户端 env_vars 转发;本机无认证测试例不需要该值。

  4. 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

接入前准备

  • Qdrant 实例与集合规划
  • uvx
  • 可用嵌入模型与受限 API Key

官方帮助

官方文档与仓库Qdrant 官方仓库问题反馈在 GitHub Issues 获取帮助

第一次调用示例

登记完成后,新开一个任务,按下面任务限定调用范围,先说清目标、范围和停止条件。

发给 Codex

第一次小范围任务

请用 Qdrant MCP 在 docs-test 集合中检索 5 个与登录排错相关的片段,并返回每条的来源元数据。
怎样算成功

集合与实际返回片段的来源字段可核对;本MCP的查询/存储工具不等于提供删除功能,清理测试数据须使用Qdrant本身的管理接口。

  1. 先定义集合用途和元数据字段。
  2. 只写入允许长期保存的内容。
  3. 用已知问题测试召回并检查来源元数据。
  4. 删除测试条目,确认数据生命周期可控。

权限与安全

凭证与连接方式

本地 stdio 或 HTTP;固定集合、地址和受限 API Key,先用测试数据。

  • 向量库可能长期保存内部文本与代码
  • 检索结果可能跨用户或项目泄露
  • 需要集合隔离、最小 Key、删除机制和嵌入数据审查

用小贺API和 MCP,把真实工具接进工作流

从一个 MCP、一个只读任务开始,先把连接、权限和结果验证清楚。

多平台支持兼容主流 MCP 客户端接入方法清楚命令与自助指令分开权限边界明确先只读再扩大范围
进入小贺API