Qdrant MCP Local

🚀 qdrant-mcp-local

ローカル環境でQdrantとMCP-server-qdrantを簡単に起動するためのDocker Compose設定です。

🚀 クイックスタート

このリポジトリでは、ローカル環境でQdrantとMCP-server-qdrantを簡単に起動できます。以下に詳細な手順を説明します。

✨ 主な機能

このリポジトリには以下のコンポーネントが含まれています。

1. Qdrant - ベクトル検索エンジン
2. MCP-server-qdrant - モデルコンテキストプロトコル（MCP）サーバー。Qdrantベクトルデータベースとの統合をサポートします。

📦 インストール

前提条件

• Docker
• Docker Compose V2（通常はDockerに含まれています）

インストール手順

1. リポジトリをクローンします。

git clone https://github.com/hirokita117/qdrant-mcp-local.git
cd qdrant-mcp-local

2. データ保存用のディレクトリを作成します。

mkdir -p data

3. Docker Composeを使用して環境を起動します（初回のビルドには少し時間がかかる場合があります）。

docker compose up -d

これにより、以下のサービスが起動します。

• Qdrant: http://localhost:6333
• MCP Server: http://localhost:8000

4. 環境を停止するには、以下のコマンドを実行します。

docker compose down

Qdrantのデータは./dataディレクトリに保存されるため、コンテナを停止しても情報は保持されます。

設定のカスタマイズ

.envファイルを編集することで、環境変数を変更できます。

トラブルシューティング

コンテナが起動しない場合

1. デバッグスクリプトを実行する

chmod +x debug.sh
./debug.sh

このスクリプトは、環境の詳細情報とエラーの詳細を表示します。 2. ログを手動で確認する

docker compose logs mcp-server

3. コンテナを再構築する 完全に再構築するには、以下のコマンドを実行します。

docker compose down
docker compose build --no-cache
docker compose up -d

4. 一般的な問題と解決策

• ポートの競合: 6333または8000ポートが既に使用されている場合は、.envファイルで別のポートを指定してください。
• ディスク容量: Dockerが使用するディスクに十分な空き容量があることを確認してください。
• Dockerデーモン: Dockerデーモンが正常に動作していることを確認してください。 詳細なトラブルシューティング情報については、docs/USAGE.mdを参照してください。

💻 使用例

MCPサーバーのエンドポイント

• MCP SSEエンドポイント: http://localhost:8000/sse

Claude Desktopでの設定例

Claude Desktopで使用する場合は、claude_desktop_config.jsonに以下の内容を追加します。

{
  "mcpServers": {
    "qdrant": {
      "command": "curl",
      "args": ["-N", "http://localhost:8000/sse"],
      "transport": "sse"
    }
  }
}

Cursorでの設定例

Cursorで使用する場合は、MCPサーバーの設定で以下のURLを指定します。

http://localhost:8000/sse

📄 ライセンス

このプロジェクトは、元のQdrantとMCP-server-qdrantのライセンスに従います。