Qdrant面料
一个全面的模型上下文协议（MCP）服务器，提供对Qdrant云管理和数据库API的访问，作为基础设施即结构生态系统的一部分。
特性
- 30个数据库工具：完成第一阶段的实施，包括所有核心数据库操作
- 完全MCP集成：与Claude Desktop和其他MCP客户端无缝协作
- 类型安全：完整的Pydantic验证和类型提示
- 异步优先：基于现代异步Python模式构建
- 织物集成：与AIANA和n8n面料无缝集成
- 综合的：集合、积分、搜索、有效载荷、健康、向量和索引操作
基础结构
qdrant结构MCP服务器位于基础设施的核心，连接：
- 当地Qdrant （localhost:6333）-您的开发实例及其集合
- Qdrant云 -管理集群、备份和生产基础架构
- 艾安娜 -具有语义记忆的AI助手(
aiana_memories收藏） - n8n面料 -矢量索引的工作流自动化(
n8n_workflows收藏）
这种混合架构实现了无缝的本地开发，同时提供了完整的云管理功能。
安装
pip install qdrant-fabric快速开始
配置Claude桌面版
添加到您的Claude桌面配置（macOS： ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"qdrant-fabric": {
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/qdrant-fabric",
"python",
"-m",
"qdrant_mcp"
],
"env": {
"QDRANT_API_KEY": "your-database-api-key",
"QDRANT_URL": "http://localhost:6333"
}
}
}
}或者直接使用Python：
{
"mcpServers": {
"qdrant-fabric": {
"command": "python",
"args": ["-m", "qdrant_mcp"],
"env": {
"QDRANT_API_KEY": "your-database-api-key",
"QDRANT_URL": "http://localhost:6333"
}
}
}
}可用工具（v0.0.4）
所有30个第一阶段数据库工具现在都可用：
收藏管理（6个工具）
qdrant_db_collections_list-列出所有收藏qdrant_db_collections_get-获取收藏详细信息qdrant_db_collections_create-创建新收藏qdrant_db_collections_delete-删除收藏qdrant_db_collections_update-更新集合配置qdrant_db_collections_exists-检查是否存在集合
积分操作（7个工具）
qdrant_db_points_upsert-插入或更新点qdrant_db_points_get-按ID检索多个点qdrant_db_points_get_single-按ID获取单点qdrant_db_points_delete-删除点qdrant_db_points_count-使用可选过滤器计数点qdrant_db_points_scroll-滚动浏览要点qdrant_db_points_batch-批处理点操作
矢量搜索（4个工具）
qdrant_db_points_search-向量相似性搜索qdrant_db_points_search_batch-批量搜索查询qdrant_db_points_recommend-基于实例的建议qdrant_db_points_recommend_batch-批量推荐
有效载荷管理（4个工具）
qdrant_db_payload_set-设置有效载荷（与现有载荷合并）qdrant_db_payload_overwrite-覆盖有效载荷（更换）qdrant_db_payload_delete-删除特定有效载荷字段qdrant_db_payload_clear-清除所有有效载荷
健康检查（5个工具）
qdrant_db_health_root-版本和构建信息qdrant_db_health_check-健康检查qdrant_db_health_liveness-活体探针qdrant_db_health_readiness-准备就绪探针qdrant_db_health_metrics-普罗米修斯指标
矢量运算（2个工具）
qdrant_db_vectors_update-更新现有点的矢量qdrant_db_vectors_delete-删除命名向量
索引管理（2个工具）
qdrant_db_index_create-创建字段索引以加快过滤速度qdrant_db_index_delete-删除字段索引
API覆盖范围
第一阶段：核心数据库操作✅ 完成（v0.0.4）
- ✅ 收藏管理（6个工具）
- ✅ 积分操作（7个工具）
- ✅ 矢量搜索（4个工具）
- ✅ 有效载荷管理（4个工具）
- ✅ 健康检查（5个工具）
- ✅ 矢量运算（2个工具）
- ✅ 索引管理（2个工具）
总计：30个工具
即将推出
- 第二阶段：云管理基础
- 第三阶段：高级搜索和发现
- 第4阶段：备份和恢复
- 看 API_COVERAGE_PLAN.md 获取完整路线图
配置
环境变量
云管理API：
QDRANT_CLOUD_API_KEY-Qdrant Cloud API承载令牌QDRANT_CLOUD_URL-云API基础URL（默认值：https://cloud.qdrant.io)
数据库API：
QDRANT_API_KEY-用于数据库访问的API密钥（对于本地实例是可选的）QDRANT_URL-数据库URL（例如。，http://localhost:6333或https://xyz.qdrant.io)
注： 云管理API工具将进入第二阶段。目前，只有数据库API工具可用。
发展
设置
git clone https://github.com/yourusername/qdrant-fabric.git
cd qdrant-fabric
pip install -e ".[dev]"运行测试
pytest代码质量
black src/ tests/
ruff check src/ tests/
mypy src/建筑
qdrant-fabric/
├── src/qdrant_mcp/
│ ├── server.py # MCP server entrypoint
│ ├── config.py # Configuration management
│ ├── cloud/ # Cloud Management API tools
│ └── database/ # Database API tools
└── tests/ # Test suite文档
贡献
欢迎投稿！请阅读我们的投稿指南并提交PR。
许可证
MIT许可证-有关详细信息，请参阅许可证文件