Qdrant Vector Database

🚀 QdrantベースのMCPサーバー

このプロジェクトは、QdrantベクトルデータベースとMCP（モデル制御プロトコル）サーバーを組み合わせて、コードスニペットの保存と検索を行うシステムを構築しています。

🚀 クイックスタート

このシステムを使ってコードスニペットの保存と検索を行うことができます。以下に、システムの概要と使い方を説明します。

✨ 主な機能

• コードスニペットの保存と管理
• 自然言語によるコード検索
• 関連コードを取得するための意味検索
• Server-Sent Events (SSE) 転送のサポート

🔧 技術詳細

システムアーキテクチャ

• Qdrant：ベクトルデータベースサーバー（ポート：6333、6334）
• MCPサーバー：コードスニペット管理サーバー（ポート：8000）
• 埋め込みモデル：(デフォルト)sentence-transformers/all-MiniLM-L6-v2

MCPツール

QDRANT MCPサーバーは以下のツールを提供します。

1. qdrant-store

• 機能：情報をQdrantデータベースに保存します。
• 入力：
  • information (文字列)：保存する情報
  • metadata (JSON)：オプションのメタデータ
• 出力：保存確認メッセージ

2. qdrant-find

• 機能：Qdrantデータベース内で関連情報を検索します。
• 入力：
  • query (文字列)：検索に使用するクエリ
• 出力：Qdrantデータベースに保存された情報を個別のメッセージで返します。

📦 インストール

前提条件

• Docker
• Docker Compose

インストールと実行

1. リポジトリをクローンする

git clone <repository-url>
cd <repository-name>

2. サービスを起動する

docker-compose up -d

3. サービスの状態を確認する

docker-compose ps

サービスへのアクセス

• Qdrantインターフェイス: http://localhost:6333/dashboard
• MCPサーバー: http://localhost:8000
• cursorなどのAI IDEで設定する場合は、以下のJSON形式を使用して構成できます。

    "qdrant": {
      "url": "http://localhost:8000/sse"
    },

📚 ドキュメント

環境変数

Qdrant

• RUST_LOG：ログレベル (デフォルト値：info)

MCPサーバー

• QDRANT_URL：Qdrantサーバーのアドレス
• COLLECTION_NAME：コレクション名
• EMBEDDING_MODEL：埋め込みモデル
• TOOL_STORE_DESCRIPTION：保存ツールの説明
• TOOL_FIND_DESCRIPTION：検索ツールの説明

データ保存

データは ./qdrant_storage ディレクトリに永続的に保存されます。

サービス管理

ログの確認

docker-compose logs -f

サービスの停止

docker-compose down

注意事項

⚠️ 重要提示

データの損失を防ぐために、定期的に qdrant_storage ディレクトリをバックアップしてください。

💡 使用建议

本番環境では、適切なセキュリティ設定を追加してください。