mcp-server-qdrant: A Qdrant MCP server

简介

mcp-server-qdrant 是一个为 Qdrant 向量搜索引擎提供的 Model Context Protocol 服务器，可作为语义记忆层来存储和检索信息。

主要功能

• 存储信息: 将数据存入 Qdrant 数据库
• 检索信息: 基于语义相似度查找相关信息

安装与运行

使用 uvx (推荐)

QDRANT_URL="http://localhost:6333" COLLECTION_NAME="my-collection" uvx mcp-server-qdrant

使用 Docker

# 构建容器
docker build -t mcp-server-qdrant .

# 运行容器
docker run -p 8000:8000 \
  -e QDRANT_URL="http://your-qdrant-server:6333" \
  -e COLLECTION_NAME="your-collection" \
  mcp-server-qdrant

通过 Smithery 安装

npx @smithery/cli install mcp-server-qdrant --client claude

配置

必需的环境变量

• COLLECTION_NAME: 要使用的集合名称

连接选项 (选择一个)

• QDRANT_URL: Qdrant 服务器的 URL
• QDRANT_LOCAL_PATH: 本地 Qdrant 数据库路径

其他设置

• QDRANT_API_KEY: Qdrant 服务器的 API 密钥
• EMBEDDING_MODEL: 要使用的嵌入模型 (默认: sentence-transformers/all-MiniLM-L6-v2)

与 Claude Desktop 集成

在 claude_desktop_config.json 的 "mcpServers" 部分添加:

{
  "qdrant": {
    "command": "uvx",
    "args": ["mcp-server-qdrant"],
    "env": {
      "QDRANT_URL": "https://your-qdrant-server:6333",
      "QDRANT_API_KEY": "your_api_key",
      "COLLECTION_NAME": "your-collection-name"
    }
  }
}

传输协议

支持两种传输协议:

• stdio (默认): 适合本地客户端
• sse: 适合远程客户端

uvx mcp-server-qdrant --transport sse  # 启用 SSE 传输

自定义工具描述

可以通过环境变量自定义工具描述:

TOOL_STORE_DESCRIPTION="存储代码片段的自定义描述" \
TOOL_FIND_DESCRIPTION="检索代码片段的自定义描述" \
uvx mcp-server-qdrant

注意: 如果无法使服务器与您的客户端协同工作，请查阅完整文档或提交问题。