Qdrant Fabric MCP 服务器

关键词

Qdrantvector databasetoolingasync serverdata management

使用说明（Markdown 格式）

项目简介

  • Qdrant Fabric 是一个面向 MCP 的服务端实现，聚合 Qdrant 数据库 API 与云管理 API 的工具集合，并通过 MCP 协议对外提供统一、可扩展的上下文服务。核心职责包括托管与管理资源、注册并执行工具、以及提供可用的接口供 LLM 客户端调用。

主要功能点

  • 完整的 MCP 服务器实现：实现对 MCP 请求的处理、工具注册与执行、以及服务器的会话管理。
  • 30 个 Phase 1 数据库工具集成：覆盖集合、点操作、向量检索、载荷管理、健康检查、向量操作与索引管理等核心数据库功能，全部可通过 MCP 客户端调用。
  • 异步优先与类型安全：基于现代异步 Python 模式，使用 Pydantic 进行参数校验，提升鲁棒性与开发效率。
  • 与 Qdrant 无缝集成：工具封装了对 Qdrant REST API 的调用，支持本地开发、云端管理及混合架构。
  • 多传输与会话能力：通过标准 MCP 服务器接口，支持未来扩展的传输通道（如 Stdio、SSE、WebSocket）等。
  • 开箱即用的开发与运行支持：提供安装、配置、运行与测试示例，便于快速搭建与集成。

安装步骤

  • 通过 Python 包管理器直接安装（示例中使用的包名与仓库内容一致）：
    • pip install qdrant-fabric
  • 安装后进入开发或生产环境即可运行 MCP 服务端（详见配置部分）。

服务器配置（MCP 客户端连接所需配置）

  • MCP 客户端（如 Claude Desktop）连接使用的配置信息需以 JSON 形式提供，示例配置如下（请按实际环境替换占位值）： { "server": "qdrant-fabric", "command": "python", "args": ["-m", "qdrant_mcp"], "env": { "QDRANT_API_KEY": "your-database-api-key", "QDRANT_URL": "http://localhost:6333" } } 说明：
  • server_name（服务器名称）为 qdrant-fabric，与仓库 README 中用于 Claude Desktop 的配置保持一致。
  • command/args 指定启动 MCP 服务器的命令与参数，示例为使用 Python 模块方式启动：python -m qdrant_mcp。
  • env 字段可选，用于提供连接 Qdrant 数据库所需的 API Key 与数据库地址。若使用本地无认证的环境，请按实际情况配置或留空。
  • 该 MCP 服务端会根据环境变量配置是否开启云管理 API 与数据库 API 的工具集成：若数据库配置（QDRANT_URL 与 QDRANT_API_KEY/api_key）完整，将注册 30 个 Phase 1 工具；若未配置数据库相关信息，将不注册数据库工具以确保安全性。

基本使用方法

  • 启动服务器后，客户端可通过 MCP 通信接口调用注册的工具，例如对 Qdrant 数据库执行集合、点、向量等操作，得到 JSON-RPC 风格的响应。
  • 常用操作包括：
    • 列出、创建、删除、更新集合等集合管理工具
    • 插入、查询、删除点、向量、载荷管理等点与向量工具
    • 向量搜索、推荐、批量操作等工具
    • 健康检查与指标导出等运维工具
  • 使用时请确保 MCP 服务器所需环境变量已正确配置，并且本地或远端的 Qdrant 实例可访问。

如需进一步使用帮助，请参考仓库中的 Fast Start / Quick Start 指引及各工具的 inputSchema 说明，与 MCP 客户端的 Tool 调用机制相结合进行开发与调试。

关键词 Qdrant, vector database, tooling, async server, data management

分类ID 2

服务器信息

访问项目