qdrant-mcp-local
About
ローカル環境でQdrantとMCP-server-qdrantを簡単に立ち上げるためのDocker Compose設定
Details
- Author
- hirokita117
- Downloads
- 329
- Categories
- Database
Jump to
- Single-command local setup of Qdrant and MCP-server-qdrant
- Persistent vector data stored in ./data/ directory
- SSE transport endpoint at http://localhost:8000/sse
- Configurable environment variables via .env file
- Includes debug script for troubleshooting
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
qdrant-mcp-localCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, create a data/ directory, then run docker compose up -d. Qdrant is available at http://localhost:6333 and the MCP server at http://localhost:8000. Stop with docker compose down. Configuration can be customized via a .env file.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"qdrant-mcp-local": {
"qdrant-mcp-local": {
"command": "docker",
"args": [
"compose",
"up",
"-d"
]
}
}
}
}McpServers
{
"qdrant-mcp-local": {
"command": "docker",
"args": [
"compose",
"up",
"-d"
]
}
}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のライセンスに準拠します。
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
