Qdrant Mcpserver

🚀 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