Qdrant Retrieve MCP Server

Qdrant Retrieve MCP サーバー

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

機能

• 複数のコレクションを対象にしたセマンティック検索
• 複数クエリのサポート
• 結果数の設定
• コレクションのソース追跡

注意：サーバーは URL で指定された Qdrant インスタンスに接続します。

注意 2：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"
      }
    }
  }
}

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

MCP server for semantic search with Qdrant vector database.

Options
  --enableHttpTransport      Enable HTTP transport [default: false]
  --enableStdioTransport     Enable stdio transport [default: true]
  --enableRestServer         Enable REST API server [default: false]
  --mcpHttpPort=<port>       Port for MCP HTTP server [default: 3001]
  --restHttpPort=<port>      Port for REST HTTP server [default: 3002]
  --qdrantUrl=<url>          URL for Qdrant vector database [default: http://localhost:6333]
  --embeddingModelType=<type> Type of embedding model to use [default: Xenova/all-MiniLM-L6-v2]
  --help                     Show this help message

Environment Variables
  QDRANT_API_KEY            API key for authenticated Qdrant instances (optional)

Examples
  $ 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