A FastAPI client and a MCPServer client for Qdrant access as a service

基本能力

产品定位

Qdrant MCP Server 是一个用于 Qdrant 知识图谱操作的双协议服务器，支持 FastAPI 和 FastMCP 协议。

核心功能

1. 灵活的服务器选择：通过 CLI 参数选择运行 FastAPI 或 FastMCP 服务器。
2. 全面的文档：包括文件结构解释、安装和使用说明、环境变量参考和开发工作流程。
3. 生产就绪：使用 Poetry 进行依赖管理，通过环境变量配置，提供构建和部署说明。
4. 可维护的结构：关注点分离，共享核心功能，清晰的开发实践。

适用场景

1. 需要灵活选择服务器协议的知识图谱操作。
2. 需要生产就绪的 Qdrant 知识图谱服务。
3. 需要可维护和可扩展的代码结构。

工具列表

1. FastAPI：提供 RESTful 端点、CORS 中间件和 OpenAPI 文档。
2. FastMCP：提供 MCP 协议兼容性、认证支持和标准化响应格式。
3. Qdrant Client：实现核心 Qdrant 操作，如集合管理、节点插入/删除和向量搜索。

常见问题解答

1. 如何选择服务器类型？：通过 CLI 参数 --server-type 选择 fastapi 或 fastmcp。
2. 如何配置环境变量？：复制 .env.example 到 .env 并编辑实际值。
3. 如何运行测试？：使用 poetry run pytest -v 运行所有测试。

使用教程

使用依赖

1. 安装 Poetry：

curl -sSL https://install.python-poetry.org | python3 -

1. 克隆仓库：

git clone https://github.com/your-repo/qdrant-mcpserver.git
cd qdrant-mcpserver

1. 安装依赖：

poetry install

1. 配置环境：

cp .env.example .env
# 编辑 .env 文件

安装教程

1. 运行 FastMCP 服务器（默认）：

poetry run python -m qdrant_mcpserver.main

1. 运行 FastAPI 服务器：

poetry run python -m qdrant_mcpserver.main --server-type fastapi

调试方式

1. 格式化代码：

poetry run black .
poetry run isort .

1. 运行测试：

poetry run pytest -v

1. 类型检查：

poetry run mypy .

许可证

None