返回 MCP 目录
public公开dns本地运行

Jimmy974_mcp-server-qdrant

一个基于Qdrant向量数据库的机器控制协议(MCP)服务器,用于存储和检索文本信息,支持语义搜索和FastEmbed集成。

article

README

🚀 Qdrant 的机器控制协议 (MCP) 服务器

Qdrant 的机器控制协议 (MCP) 服务器可用于存储和检索信息,借助 Qdrant 向量数据库,为信息管理提供了高效的解决方案。

🚀 快速开始

本 MCP 服务器借助 Qdrant 向量数据库实现信息的存储与检索。你可以按照以下步骤快速启动服务器。

✨ 主要特性

  • 📝 使用可选元数据存储文本信息在 Qdrant 中。
  • 🔍 半同义词搜索已存储的信息。
  • 💨 快速嵌入集成以进行文本嵌入。
  • ⚙️ 环境变量配置。
  • 🐳 Docker 支持。

📦 安装指南

使用 pip

pip install mcp-server-qdrant

从源码安装

git clone https://github.com/your-org/mcp-server-qdrant.git
cd mcp-server-qdrant
make setup

💻 使用示例

本地运行

python -m mcp_server_qdrant.main

或使用 make 命令:

make run

Docker

docker-compose up

📚 详细文档

配置

通过环境变量进行配置。可以根据 .env.example 文件创建一个 .env 文件:

cp .env.example .env

编辑 .env 文件以配置服务器:

# Qdrant 配置
QDRANT_URL=http://localhost:6333
QDRANT_API_KEY=your-api-key

# 集合名称
COLLECTION_NAME=memories

# 嵌入提供程序配置
EMBEDDING_PROVIDER=fastembed
EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2

工具

MCP 服务器提供以下工具:

qdrant - store

将信息存储在 Qdrant 数据库中。

information: 要存储的文本内容
metadata: 可选的 JSON 元数据,用于与文本关联

qdrant - find

使用语义搜索在 Qdrant 数据库中查找信息。

query: 搜索查询

开发

测试

make test

格式化

make format

检查代码质量

make lint

构建

make build

📄 许可证

本项目采用 Apache License 2.0 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端