Qdrantベクトル検索エンジン上に構築されたMCPサービス

はじめに

mcp-server-qdrant は、Qdrant をベースに構築されたベクトル検索エンジンです。 モデル・コンテキスト・プロトコル (エムシーピー)サーバーである。これは主に、AIシステムが記憶を保存・検索するために使用され、特に意味検索を必要とするシナリオに適している。このツールは、情報をベクトルに変換することで、効率的な意味記憶管理を可能にする。以下のような様々なクライアントをサポートしている。 クロード デスクトップとカーソルにより、開発者やユーザーは簡単に情報を保存し、検索することができます。個人のナレッジ管理やチームのコード検索など、mcp-server-qdrantは使いやすいソリューションを提供します。エンベッディングの生成には FastEmbed モデルを使用し、デフォルトでは sentence-transformers/all-MiniLM-L6-v2また、Apache 2.0ライセンスに基づく完全なオープンソースであり、誰でも自由に使用したり変更したりすることができる。

機能一覧

• 情報の保存テキスト情報やメタデータをQdrantデータベースに保存し、自然言語記述や構造化データをサポートします。
• 意味検索:: クエリに基づいて、データベース内の最も関連性の高い情報やコードスニペットを素早く見つけることができます。
• 複数クライアントのサポートクロードデスクトップ、カーソルなどのMCP互換ツールとシームレスに連携。
• カスタマイズされたツールの説明:: コード検索やナレッジマネジメントなど、さまざまなシナリオに合わせて、店舗や検索機能の説明をユーザーが調整できるようにする。
• ローカルモードとリモートモードローカルでQdrantを実行することも、リモートサーバーに接続することも可能です。
• 組み込みモデルのサポートFastEmbedテクノロジーを採用し、デフォルトで効率的なエンベッド生成を実現。

ヘルプの使用

設置プロセス

mcp-server-qdrantのインストールは非常に簡単で、主に以下の2つの方法があります。 uvx 直接実行するか、Smithery経由でクロードデスクトップに自動インストールします：

方法1：uvxをインストールして実行する

1. 環境を整えるPython 3.10以上がコンピュータにインストールされていることを確認してください。 uvx(軽量なPythonパッケージ管理ツール）。もし uvx以下のコマンドでインストールできる：

pip install uv

2. 環境変数の設定ターミナルで以下のコマンドを入力し、Qdrantサーバーのアドレスとコレクション名を設定します。

QDRANT_URL="http://localhost:6333" COLLECTION_NAME="my-collection" uvx mcp-server-qdrant

• QDRANT_URLQdrantサーバのアドレスです。ローカルでQdrantを起動している場合は、デフォルト値のままで構いません。
• COLLECTION_NAME: "my-collection "のように、使用したいコレクションの名前。
• APIキーが必要な場合は QDRANT_API_KEY="你的密钥".

3. オペレーション・サーバーサーバーはコマンド実行後に起動します。 stdio 転送プロトコル。リモートアクセスが必要な場合は --transport sse パラメーター

QDRANT_URL="http://localhost:6333" COLLECTION_NAME="my-collection" uvx mcp-server-qdrant --transport sse

方法2：Smithery経由でクロードデスクトップにインストールする

1. スミザリーの設置ターミナルで以下のコマンドを実行し、Node.jsの環境があることを確認する：

npx @smithery/cli install mcp-server-qdrant --client claude

2. クロードデスクトップの設定編集部 claude_desktop_config.json ファイルを "mcpServers" セクションに以下を追加する：

{
"qdrant": {
"command": "uvx",
"args": ["mcp-server-qdrant"],
"env": {
"QDRANT_URL": "http://localhost:6333",
"QDRANT_API_KEY": "你的密钥",
"COLLECTION_NAME": "你的集合名称"
}
}
}

3. スタート・クロード・デスクトップ設定を保存した後、Claude Desktop を起動すると自動的にサーバーが起動します。

ローカルモード設定

リモートのQdrantサーバーに頼りたくない場合は、ローカルモードを使うことができます：

1. 交換 QDRANT_URL というのも QDRANT_LOCAL_PATHローカルデータベースのパスを指定します：

   {
   "qdrant": {
   "command": "uvx",
   "args": ["mcp-server-qdrant"],
   "env": {
   "QDRANT_LOCAL_PATH": "/path/to/qdrant/database",
   "COLLECTION_NAME": "my-collection"
   }
   }
   }
   

2. 実行後、Qdrantはローカルモードで起動し、全てのデータは指定されたパスに保存されます。

主な機能

機能1：情報の保存qdrant-store)

• 使用Qdrantデータベースにテキスト、コードスニペット、メモなどの情報を保存できます。
• 手続き:
  1. 保存するコンテンツ、たとえば説明的なテキスト(information)とオプションのメタデータ(metadata).
     • 例information="这是一个计算器函数的描述"属metadata={"code": "def calc(x): return x + 1"}
  2. クロードデスクトップを使用している場合は、クライアントを開き、同様のコマンドを入力します：

     qdrant-store information="这是一个计算器函数的描述" metadata={"code": "def calc(x): return x + 1"}
     

  3. サーバーは、保存が成功したことを示す確認メッセージを返す。
• 銘記するメタデータはオプションで、コードやラベルなどの追加情報を保存するために使用できる。

機能2：情報の取得(qdrant-find)

• 使用自然言語によるクエリに基づいて、データベース内の最も関連性の高いコンテンツを検索します。
• 手続き:
  1. クエリを入力します。例えば、ある関数のコードを検索したい場合などです：

     qdrant-find query="计算器函数"
     

  2. 各メッセージは別々に表示され、メタデータには説明とコードが含まれる。
  3. 返された結果を調べ、必要なものを見つける。
• チップクエリが具体的であればあるほど、より正確な結果が得られます。例えば、"関数 "よりも "電卓関数 "の方が正確です。

機能3：カスタムコード検索

• 使用サーバーを開発者のためのコード検索ツールにする。
• 設定ステップ:
  1. 環境変数の設定とツールの説明の調整

     QDRANT_URL="http://localhost:6333" COLLECTION_NAME="code-snippets" \
     TOOL_STORE_DESCRIPTION="存储代码片段，information 是描述，metadata 包含代码" \
     TOOL_FIND_DESCRIPTION="根据描述搜索代码片段" \
     uvx mcp-server-qdrant --transport sse
     

  2. ある カーソル サーバーのアドレスは、例えば http://localhost:8000/sse.
  3. コードを保存する：

     qdrant-store information="计算两数之和" metadata={"code": "def add(a, b): return a + b"}
     

  4. 検索コード

     qdrant-find query="两数相加的函数"
     

• 効果再利用しやすいように、最もマッチしたコード・スニペットを返します。

使用例

1. 個人の知識管理メモや文書の断片を保存し、いつでも自然言語で取り出すことができます。
2. チームワークコードやナレッジベースを共有するためにクラウド上でサーバーを稼働させる。
3. 地域開発ネットワークに依存しないローカルモードでテスト。

ほら

• Qdrantサービスが（ローカルまたはリモートで）開始されていることを確認してください。
• デフォルトの埋め込みモデルは sentence-transformers/all-MiniLM-L6-v2FastEmbed がサポートしているモデルでのみ使用できます。
• SSEモードはリモートアクセスに適しており、stdioはローカルクライアントに適している。