🚀 Qdrant MCP Server

Qdrant MCP Server 是一个支持快速API和FastMCP协议的知识图谱操作双协议服务器，为Qdrant提供服务访问，可灵活选择服务器类型，具备全面文档支持，适用于生产环境。

🚀 快速开始

Qdrant MCP Server 是一个双协议知识图谱操作服务器，支持Qdrant的知识图谱操作，兼容快速API和FastMCP协议。以下是启动服务器的示例代码：

import argparse
import uvicorn
from fastapi_server import app as fastapi_app
from fastmcp_server import app as fastmcp_app
from config import settings

def run_fastapi():
    """运行FastAPI服务器"""
    print(f"正在启动FastAPI服务器，端口为 {settings.port}")
    uvicorn.run(
        fastapi_app,
        host="0.0.0.0",
        port=settings.port,
        log_level="info"
    )

def run_fastmcp():
    """运行FastMCP服务器"""
    print(f"正在启动FastMCP服务器，端口为 {settings.mcp_port}")
    fastmcp_app.run(port=settings.mcp_port)

if __name__ == "__main__":
    parser = argparse.ArgumentParser(description="运行Qdrant MCP Server")
    parser.add_argument(
        "--server-type",
        choices=["fastapi", "fastmcp"],
        default="fastmcp",
        help="要运行的服务器类型（默认：fastmcp）"
    )
    args = parser.parse_args()

    if args.server_type == "fastapi":
        run_fastapi()
    else:
        run_fastmcp()

✨ 主要特性

核心功能模块

1. FastAPI 服务器
   • 提供RESTful API接口。
   • 支持JSON请求和响应。
   • 内置于uvicorn Web服务器。
2. FastMCP 服务器
   • 实现MCP协议栈。
   • 支持远程过程调用(RPC)。
   • 基于asyncio的异步处理。
3. 配置管理
   • 统一的环境变量配置。
   • 端口和地址自动获取。
   • 日志级别动态调整。

核心特点

1. 灵活的服务器选择
   • 可通过命令行参数指定FastAPI或FastMCP。
   • 共享配置和Qdrant客户端。
   • 统一的端点定义。
2. 全面文档支持
   • 有详细的文件结构说明。
   • 提供安装使用指南。
   • 包含环境变量参考。
   • 有开发流程说明。
3. 生产环境就绪
   • 采用poetry进行依赖管理。
   • 支持环境变量配置。
   • 有构建和部署说明。
4. 维护良好的结构
   • 职责分离明确。
   • 核心功能可复用。
   • 有规范的开发流程。

📦 安装指南

使用poetry进行依赖管理：

poetry install

💻 使用示例

基础用法

启动服务器：

# 启动FastAPI服务器，默认端口8000
python -m qdrant_mcp_server.main --server-type fastapi

# 或者启动MCP服务器，默认端口9000
python -m qdrant_mcp_server.main --server-type fastmcp

📚 详细文档

项目结构

src/qdrant_mcp_server/
├── fastapi_server.py       # FastAPI服务器实现
├── fastmcp_server.py      # FastMCP服务器实现
└── config.py              # 配置管理模块

开发流程

1. 创建虚拟环境：

   poetry install
   

2. 运行测试：

   poetry run pytest --cov=qdrant_mcp_server --cov-report=term-missing
   

3. 格式检查：

   poetry run black .
   poetry run isort .
   

4. 类型检查：

   poetry run mypy .
   

部署指南

构建生产包：

poetry build

系统范围安装：

pip install dist/*.whl

作为服务运行：

python -m qdrant_mcp_server.main --server-type fastmcp