项目概述

Qdrant MCP Server 是一个支持快速API和FastMCP协议的知识图谱操作双协议服务器。该服务器为Qdrant提供服务访问。

main.py

main.py 是项目的入口点，并通过命令行参数选择要运行的服务器类型。

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()

Qdrant MCP 服务端

一个双协议知识图谱操作服务器，支持Qdrant的知识图谱操作，兼容快速API和FastMCP协议。

项目结构

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

核心功能模块

1. FastAPI 服务器

   • 提供RESTful API接口
   • 支持JSON请求和响应
   • 内置于uvicorn Web服务器

2. FastMCP 服务器

   • 实现MCP协议栈
   • 支持远程过程调用(RPC)
   • 基于asyncio的异步处理

3. 配置管理

   • 统一的环境变量配置
   • 端口和地址自动获取
   • 日志级别动态调整

安装步骤

使用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

开发流程

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

核心特点：

1. 灵活的服务器选择

   • 命令行参数指定FastAPI或FastMCP
   • 共享配置和Qdrant客户端
   • 统一的端点定义

2. 全面文档支持

   • 详细的文件结构说明
   • 安装使用指南
   • 环境变量参考
   • 开发流程说明

3. 生产环境就绪

   • poetry依赖管理
   • 环境变量配置
   • 构建和部署说明

4. 维护良好的结构

   • 职责分离明确
   • 核心功能复用
   • 规范的开发流程