Better Qdrant MCP Server

🚀 より良い Qdrant MCP サーバー

Qdrant ベクトルデータベースのモデルコンテキストプロトコル（MCP）サーバーを強化したものです。このサーバーは、Qdrant コレクションの管理、ドキュメントの追加、および意味検索の実行といった強力なツールを提供します。

✨ 主な機能

• コレクションの一覧表示：利用可能なすべての Qdrant コレクションを表示します。
• ドキュメントの追加：ドキュメントを処理して Qdrant コレクションに追加します。複数の埋め込みサービスをサポートしています。
• 検索：ベクトルデータベース上で意味検索を実行します。
• コレクションの削除：Qdrant データベースからコレクションを削除します。

📦 インストール

npm install -g better-qdrant-mcp-server

または、直接 npx を使用することもできます。

npx better-qdrant-mcp-server

📚 ドキュメント

設定

このサーバーは環境変数を使用して設定します。プロジェクトのルートディレクトリに .env ファイルを作成し、以下のように変数を設定できます。

# Qdrant 設定
QDRANT_URL=http://localhost:6333
QDRANT_API_KEY=あなたの_api_キー（必要な場合）

# 埋め込みサービス API キー
OPENAI_API_KEY=あなたの_openai_api_キー
OPENROUTER_API_KEY=あなたの_openrouter_api_キー
OLLAMA_ENDPOINT=http://localhost:11434

サポートされている埋め込みサービス

• OpenAI：API キーが必要です。
• OpenRouter：API キーが必要です。
• Ollama：ローカルの埋め込みモデル（デフォルトのエンドポイント：http://localhost:11434）
• FastEmbed：ローカルの埋め込みモデル

Claude との連携

この MCP サーバーを Claude と連携させるには、MCP 設定構成ファイルに以下のように追加します。

{
  "mcpServers": {
    "better-qdrant": {
      "command": "npx",
      "args": ["better-qdrant-mcp-server"],
      "env": {
        "QDRANT_URL": "http://localhost:6333",
        "QDRANT_API_KEY": "あなたの_api_キー（必要な場合）",
        "DEFAULT_EMBEDDING_SERVICE": "ollama",
        "OPENAI_API_KEY": "あなたの_openai_api_キー",
        "OPENAI_ENDPOINT": "https://api.openai.com/v1",
        "OPENROUTER_API_KEY": "あなたの_openrouter_api_キー",
        "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": "あなたの検索クエリ",
  "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 キー

📄 ライセンス

MIT