MCP Server Qdrant Retrive

🚀 Qdrant 语义検索 MCP サーバー

Qdrant ベクトルデータベースと組み合わせて使用する、意味検索用の MCP サーバーです。

🚀 クイックスタート

このサーバーは、URL で指定された Qdrant インスタンスに接続します。初回の検索は、MCP サーバーが必要な埋め込みモデルをダウンロードするため、少し時間がかかる場合があります。

✨ 主な機能

• 複数コレクションの意味検索
• 複数クエリのサポート
• 結果数の設定可能
• コレクションのソース追跡

⚠️ 重要提示

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

⚠️ 重要提示

初回の検索は、MCP サーバーが必要な埋め込みモデルをダウンロードするため、少し時間がかかる場合があります。

📚 ドキュメント

🔧 API

ツール

• qdrant_retrieve
  • 複数のクエリに基づいて、複数の Qdrant ベクトルストレージコレクションから意味的に類似したドキュメントを検索します。
  • 入力:
    • collectionNames (string[]): 検索対象の Qdrant コレクション名の配列
    • topK (number): 検索する最も類似したドキュメントの数（デフォルト: 3）
    • query (string[]): クエリテキストの配列
  • 戻り値:
    • 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]
  --help                     このヘルプ情報を表示する

環境変数
  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