Qdrant Mcpserver

🚀 Qdrant MCP Server

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. 良好な構造

   • 責任分離が明確です。
   • 核心機能の再利用が可能です。
   • 標準化された開発フローがあります。