MCP Qdrant Server With Qdrant Db

🚀 MCP プロトコルに基づくコードスニペット管理サーバと Qdrant ベクトルデータベースの統合

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

✨ 主な機能

• コードスニペットの保存と管理
• 自然言語に基づくコード検索
• 意味検索による関連コードの検索
• Server - Sent Events（SSE）データ転送プロトコルのサポート

📦 システムアーキテクチャ

📚 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 Server インターフェース：http://localhost:8000
• cursor などの AI 開発環境の設定については、以下の 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

サービスの実行を停止する

docker-compose down

📄 注意事項

⚠️ 重要提示

重要なデータは定期的にバックアップして、予期せぬデータ損失を防いでください。

💡 使用建议

本番環境では、適切なセキュリティ対策を講じてください。