使用 OpenAI 嵌入的 MCP Qdrant 服务器

此 MCP 服务器使用 Qdrant 向量数据库和 OpenAI 嵌入提供向量搜索功能。

特性

• 使用 OpenAI 嵌入在 Qdrant 集合中进行语义搜索
• 列出可用集合
• 查看集合信息

先决条件

• 已安装 Python 3.10+
• Qdrant 实例（本地或远程）
• OpenAI API 密钥

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Qdrant 向量搜索服务器到 Claude Desktop：

npx -y @smithery/cli install @amansingh0311/mcp-qdrant-openai --client claude

手动安装

1. 克隆此仓库：

   git clone https://github.com/yourusername/mcp-qdrant-openai.git
   cd mcp-qdrant-openai
   

2. 安装依赖项：

   pip install -r requirements.txt
   

配置

设置以下环境变量：

• OPENAI_API_KEY：您的 OpenAI API 密钥
• QDRANT_URL：指向您的 Qdrant 实例的 URL（默认："http://localhost:6333"）
• QDRANT_API_KEY：您的 Qdrant API 密钥（如适用）

使用方法

直接运行服务器

python mcp_qdrant_server.py

使用 MCP CLI 运行

mcp dev mcp_qdrant_server.py

在 Claude Desktop 中安装

mcp install mcp_qdrant_server.py --name "Qdrant-OpenAI"

可用工具

query_collection

使用 OpenAI 嵌入在 Qdrant 集合中进行语义搜索。

• collection_name：要搜索的 Qdrant 集合名称
• query_text：自然语言搜索查询
• limit：返回结果的最大数量（默认：5）
• model：使用的 OpenAI 嵌入模型（默认：text-embedding-3-small）

list_collections

列出 Qdrant 数据库中的所有可用集合。

collection_info

获取特定集合的信息。

• collection_name：要获取信息的集合名称

在 Claude Desktop 中的示例用法

一旦在 Claude Desktop 中安装，您可以这样使用这些工具：

我的 Qdrant 数据库中有哪些集合？

在我的“documents”集合中搜索关于气候变化的文档。

显示“articles”集合的信息。