より優れたQdrant MCPサーバー
Qdrantベクターデータベースの機能を強化するモデルコンテキストプロトコル(MCP)サーバー。このサーバーは、Qdrantコレクションの管理、ドキュメントの追加、セマンティック検索の実行のためのツールを提供します。
特徴
- コレクションの一覧: 利用可能なすべてのQdrantコレクションを表示
- ドキュメントの追加: さまざまな埋め込みサービスを使用して、ドキュメントを処理して Qdrant コレクションに追加します。
- 検索:ベクターデータベース全体でセマンティック検索を実行します
- コレクションの削除: Qdrantデータベースからコレクションを削除します
インストール
npm install -g better-qdrant-mcp-server
または、npx で直接使用します。
npx better-qdrant-mcp-server
構成
サーバーは設定に環境変数を使用します。これらはプロジェクトルートの.env
ファイルで設定できます。
# Qdrant Configuration
QDRANT_URL=http://localhost:6333
QDRANT_API_KEY=your_api_key_if_needed
# Embedding Service API Keys
OPENAI_API_KEY=your_openai_api_key
OPENROUTER_API_KEY=your_openrouter_api_key
OLLAMA_ENDPOINT=http://localhost:11434
サポートされている埋め込みサービス
- OpenAI : APIキーが必要です
- OpenRouter : APIキーが必要です
- Ollama : ローカル埋め込みモデル (デフォルトのエンドポイント: http://localhost:11434 )
- FastEmbed : ローカル埋め込みモデル
クロードとの使用
この MCP サーバーを Claude で使用するには、MCP 設定構成ファイルに追加します。
{
"mcpServers": {
"better-qdrant": {
"command": "npx",
"args": ["better-qdrant-mcp-server"],
"env": {
"QDRANT_URL": "http://localhost:6333",
"QDRANT_API_KEY": "your_api_key_if_needed",
"DEFAULT_EMBEDDING_SERVICE": "ollama",
"OPENAI_API_KEY": "your_openai_api_key",
"OPENAI_ENDPOINT": "https://api.openai.com/v1",
"OPENROUTER_API_KEY": "your_openrouter_api_key",
"OPENROUTER_ENDPOINT": "https://api.openrouter.com/v1",
"OLLAMA_ENDPOINT": "http://localhost:11434",
"OLLAMA_MODEL": "nomic-embed-text"
}
}
}
}
コマンド例
リストコレクション
use_mcp_tool
server_name: better-qdrant
tool_name: list_collections
arguments: {}
ドキュメントを追加
use_mcp_tool
server_name: better-qdrant
tool_name: add_documents
arguments: {
"filePath": "/path/to/your/document.pdf",
"collection": "my-collection",
"embeddingService": "openai",
"chunkSize": 1000,
"chunkOverlap": 200
}
検索
use_mcp_tool
server_name: better-qdrant
tool_name: search
arguments: {
"query": "your search query",
"collection": "my-collection",
"embeddingService": "openai",
"limit": 5
}
コレクションを削除
use_mcp_tool
server_name: better-qdrant
tool_name: delete_collection
arguments: {
"collection": "my-collection"
}
要件
- Node.js >= 18.0.0
- 実行中のQdrantサーバー(ローカルまたはリモート)
- 使用したい埋め込みサービスのAPIキー
ライセンス
マサチューセッツ工科大学