MCP Qdrant Docs

🚀 MCP-Quant 文檔

mcp-quant 是一款 MCP 服務器，它能夠從指定網站抓取內容，並將其索引到 Qdrant 向量數據庫中。同時，該服務器還提供了一個工具，可藉助自然語言查詢來回答關於文檔的問題。

🚀 快速開始

mcp-quant 可幫助你輕鬆實現網站內容的抓取、索引以及自然語言查詢功能。下面為你介紹其使用方法。

✨ 主要特性

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 向量數據庫中，並提供自然語言查詢功能。該工具支持靈活的配置和擴展，適用於多種文檔管理和檢索場景。