Qdrant Retrieve

🚀 Qdrant 検索 MCP サーバー

このサーバーは、Qdrant ベクトルデータベースを用いた、セマンティック検索用の MCP サーバーです。セマンティック検索を通じて、関連するドキュメントを効率的に取得できます。

🚀 クイックスタート

このサーバーを使用する前に、いくつかの注意点があります。

⚠️ 重要提示

このサーバーは、指定された URL の Qdrant インスタンスに接続します。

初回の検索は、MCP サーバーが必要な埋め込みモデルをダウンロードするため、遅くなる可能性があります。

✨ 主な機能

• 複数のコレクションに対するセマンティック検索が可能です。
• 複数のクエリをサポートし、一度に複数の条件で検索できます。
• 取得する結果の数を設定できます。
• 検索結果のコレクションのソースを追跡できます。

📚 ドキュメント

🔧 API 詳細

ツール

• qdrant_retrieve
  • 複数の Qdrant ベクトルストレージコレクションから、複数のクエリに基づいて意味的に類似したドキュメントを検索します。
  • 入力:
    • collectionNames (文字列[]): 検索対象となる Qdrant コレクション名の配列です。
    • topK (数値): 取得する最も類似したドキュメントの数です（デフォルト: 3）。
    • query (文字列[]): 検索クエリの配列です。
  • 戻り値:
    • results: 検索されたドキュメントの配列で、以下の情報を含みます。
      • query: この結果を生成したクエリです。
      • collectionName: この結果のソースとなったコレクション名です。
      • text: ドキュメントの本文内容です。
      • score: 類似度スコア（0 から 1 の範囲）です。

💻 使用例

Claude Desktop での使用方法

claude_desktop_config.json ファイルに以下の内容を追加してください。

{
  "mcpServers": {
    "qdrant": {
      "command": "npx",
      "args": ["-y", "@gergelyszerovay/mcp-server-qdrant-retrive"],
      "env": {
        "QDRANT_API_KEY": "your_api_key_here"
      }
    }
  }
}

コマンドラインオプション

セマンティック検索用の Qdrant ベクトルデータベースの MCP サーバーです。

オプション
  --enableHttpTransport      HTTP トランスポートを有効にします [デフォルト: false]
  --enableStdioTransport     標準入出力トランスポートを有効にします [デフォルト: true]
  --enableRestServer         REST API サーバーを有効にします [デフォルト: false]
  --mcpHttpPort=<ポート>       MCP HTTP サーバーのポート番号を指定します [デフォルト: 3001]
  --restHttpPort=<ポート>      REST HTTP サーバーのポート番号を指定します [デフォルト: 3002]
  --qdrantUrl=<URL>          Qdrant ベクトルデータベースの URL を指定します [デフォルト: http://localhost:6333]
  --embeddingModelType=<タイプ> 使用する埋め込みモデルのタイプを指定します [デフォルト: Xenova/all-MiniLM-L6-v2]
  --ヘルプ                     このヘルプメッセージを表示します

環境変数
  QDRANT_API_KEY            認証用の Qdrant インスタンスの API キー（オプション）

例
  $ mcp-qdrant --enableHttpTransport
  $ mcp-qdrant --mcpHttpPort=3005 --restHttpPort=3006
  $ mcp-qdrant --qdrantUrl=http://qdrant.example.com:6333
  $ mcp-qdrant --embeddingModelType=Xenova/all-MiniLM-L6-v2