qdrant-mcp-local
ローカル環境でQdrantとMCP-server-qdrantを簡単に立ち上げるためのDocker Compose設定
hirokita117
README
qdrant-mcp-local
ローカル環境でQdrantとMCP-server-qdrantを簡単に立ち上げるためのDocker Compose設定です。
概要
このリポジトリは以下のコンポーネントを含んでいます：
- Qdrant - ベクトル検索エンジン
- MCP-server-qdrant - Model Context Protocol (MCP)サーバー。Qdrantベクトルデータベースとの連携をサポートします。
セットアップ方法
前提条件
- Docker
- Docker Compose V2 (現在のDockerには通常組み込まれています)
使用方法
- リポジトリをクローンします：
git clone https://github.com/hirokita117/qdrant-mcp-local.git
cd qdrant-mcp-local
- データ保存用のディレクトリを作成します：
mkdir -p data
- Docker Composeを使って環境を起動します（初回はビルドに少し時間がかかります）：
docker compose up -d
これにより以下のサービスが起動します：
- Qdrant: http://localhost:6333
- MCP Server: http://localhost:8000
- 環境を停止するには：
docker compose down
Qdrantのデータは./dataディレクトリに保存されるため、コンテナを停止しても情報は保持されます。
設定のカスタマイズ
.envファイルを編集することで、環境変数を変更できます。
トラブルシューティング
コンテナが起動しない場合
- デバッグスクリプトを実行:
chmod +x debug.sh
./debug.sh
このスクリプトにより、環境の詳細情報とエラーの詳細が表示されます。
- 手動でログを確認:
docker compose logs mcp-server
- コンテナ再構築:
環境を完全に再構築するには：
docker compose down
docker compose build --no-cache
docker compose up -d
- 一般的な問題と解決策:
- ポート競合: 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のライセンスに準拠します。
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
MCP Package Docs Server
Facilitates LLMs to efficiently access and fetch structured documentation for packages in Go, Python, and NPM, enhancing software development with multi-language support and performance optimization.
Claude Code MCP
An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.
@kazuph/mcp-taskmanager
Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
Linear MCP Server
Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.
mermaid-mcp-server
A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images.
Jira-Context-MCP
MCP server to provide Jira Tickets information to AI coding agents like Cursor
Linear MCP Server
A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.
Sequential Thinking MCP Server
This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.