MCP Qdrant Docs

🚀 MCP-Quant ドキュメント

mcp-quant は、指定されたウェブサイトからコンテンツを収集し、それを Qdrant ベクトルデータベースにインデックス化するための MCP サーバーです。このサーバーは、ドキュメントに関する質問に自然言語で回答するツールを提供します。

🚀 クイックスタート

mcp-quant を使用することで、指定したサイトのコンテンツを Qdrant ベクトルデータベースに簡単にインデックス化し、自然言語でのクエリに対応できます。以下に基本的な使い方を説明します。

✨ 主な機能

1. 自動収集とインデックス化

• 起動時の自動収集: ターゲットサイトのコンテンツがインデックスされていない場合、または --force-reindex が有効になっている場合、サーバーは指定されたウェブサイトから自動的にコンテンツを収集します。
• テキストフラグメントの処理と埋め込み: 選択された文エンコーダーを使用して、収集されたコンテンツを処理し、ベクトル空間に埋め込みます。
• Qdrant コレクションへの保存: 処理されたテキストフラグメントとその埋め込みを指定された Qdrant コレクションに保存します。

2. クエリツール

• 動的なツール名生成: ツール名は DOCS_URL のホスト名に基づいて自動生成されます。例えば、入力サイトが https://reactrouter.com/ の場合、ツール名は ask_reactrouter_docs となります。
• 自然言語クエリ: ドキュメントの内容に関する自然言語クエリをサポートし、Qdrant を使用してベクトル類似度検索を行い、最も関連性の高いテキストフラグメントを返します。

3. 柔軟性と拡張性

• 複数のモデルサポート: 異なる文エンコーダー/埋め込みモデル（例: all-MiniLM-L6-v2、Xenova/all-MiniLM-L6-v2 など）を選択できます。
• 収集パラメータの設定可能: 収集深度や収集リンク数の制限などを設定でき、コンテンツ収集の完全性と規範性を確保します。

📦 インストール

1. インストール

npm install -g @kazuph/mcp-qdrant-docs

2. npx を使用した実行

npx @kazuph/mcp-qdrant-docs --start-url https://example.com/ --collection-name my_docs

3. 設定ファイルの例

claude_desktop_config.json にサーバーインスタンスを追加します。

{
  "mcpServers": {
    // ... 他のサーバー ...
    "react-router-docs": {
      "command": "npx",
      "args": [
        "@kazuph/mcp-qdrant-docs"
      ],
      "env": {
        "DOCS_URL": "https://reactrouter.com/",
        "QDRANT_URL": "http://your-qdrant-instance:6333",  # あなたの Qdrant アドレスに置き換える
        "COLLECTION_NAME": "react-router-docs"  # 基本名、実際には "react-router-docs-reactrouter_com"
      }
    }
    // ... 他のサーバー ...
  }
}

💻 使用例

基本的な使用法

# Hono.dev ドキュメント用の専用サーバーインスタンスを追加する：
{
  "mcpServers": {
    // ... 他のサーバー ...
    "hono_docs": {
      "command": "npx",
      "args": [
        "@kazuph/mcp-qdrant-docs"
      ],
      "env": {
        "DOCS_URL": "https://hono.dev/",
        "QDRANT_URL": "http://your-qdrant-instance:6333",  # あなたの Qdrant アドレスに置き換える
        "COLLECTION_NAME": "hono_docs_hono_dev"  # 基本名、実際には "hono_docs_hono_dev"
      }
    }
    // ... 他のサーバー ...
  }
}

このように設定すると、MCP クライアントは ask_hono_docs という名前のツールを提供します（ask_hono_dev_docs ではなく）。

• ツール名: ask_<doc name>_docs（例: ask_reactrouter_docs）
• 説明: 指定されたサイト (DOCS_URL) のドキュメント内容に関する質問。
• 入力: ドキュメント内容に関する自然言語クエリ。

サーバーは自動的にウェブサイトを収集し（コレクションが存在しない場合または --force-reindex を使用する場合）、内容を指定された Qdrant コレクションにインデックス化し、提供されたツール (ask_reactrouter_docs) を使用してインデックスを介してクエリに回答します。

高度な使用法

1. React Router ドキュメントサーバーインスタンスの追加

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "react-router-docs": {
      "command": "npx",
      "args": [
        "@kazuph/mcp-qdrant-docs"
      ],
      "env": {
        "DOCS_URL": "https://reactrouter.com/",
        "QDRANT_URL": "http://localhost:6333",  # Qdrant がローカルで実行されていると仮定
        "COLLECTION_NAME": "react-router-docs"  # コレクション名
      }
    }
  }
}

2. サーバーの起動

npx @kazuph/mcp-qdrant-docs --start-url https://reactrouter.com/ --collection-name react-router-docs

🔧 技術詳細

コマンドラインオプション

1. 必須パラメータ

• --start-url: 収集を開始する URL を指定します。
• --collection-name: Qdrant コレクションの名前を指定します。

2. オプションパラメータ

• --depth: 収集深度。デフォルトは 1 です。
• --max-links: 最大収集リンク数。デフォルトは 50 です。
• --exclude-domains: 特定のドメインを除外します。カンマ区切りで指定します。
• --force-reindex: 既存のコレクションを強制的に再インデックス化します。

⚠️ 重要提示

⚠️ 重要提示

• Qdrant サービスが正しく実行され、指定されたアドレスからアクセスできることを確認してください。
• 大量のコンテンツを収集する場合は、収集深度とリンク数を制限して、ターゲットウェブサイトにかかる負荷を軽減することをお勧めします。
• --force-reindex を使用する前に、ターゲットコレクションが存在しないか、そのデータが不要であることを確認してください。

まとめ

MCP サーバー mcp-quant を使用することで、指定されたサイトのコンテンツを Qdrant ベクトルデータベースに簡単にインデックス化し、自然言語クエリ機能を提供できます。このツールは柔軟な設定と拡張性をサポートしており、さまざまなドキュメント管理と検索シナリオに適しています。