What is Qdrant Mcp Local

qdrant-mcp-local is a Docker Compose setup for easily launching Qdrant and MCP-server-qdrant in a local environment. It includes a vector search engine (Qdrant) and a server that supports the Model Context Protocol (MCP) for integration with the Qdrant vector database.

Use cases

Use cases include setting up a local development environment for testing applications that utilize vector searches, integrating with applications like Claude Desktop and Cursor, and developing solutions that leverage the Model Context Protocol for real-time data processing.

How to use

To use qdrant-mcp-local, clone the repository, create a data directory, and start the environment using Docker Compose. You can stop the environment with the ‘docker compose down’ command, and data will be preserved in the ‘./data’ directory.

Key features

Key features include easy setup with Docker Compose, integration with Qdrant for vector searches, support for the Model Context Protocol (MCP), and customizable environment variables through the ‘.env’ file.

Where to use

qdrant-mcp-local can be used in fields that require vector search capabilities, such as machine learning, natural language processing, and data analysis, where efficient retrieval of high-dimensional data is essential.

qdrant-mcp-local

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

概要

このリポジトリは以下のコンポーネントを含んでいます：

1. Qdrant - ベクトル検索エンジン
2. MCP-server-qdrant - Model Context Protocol (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のライセンスに準拠します。