MCP-Quant 文档

介绍

mcp-quant 是一个 MCP 服务器，用于从指定网站抓取内容，并将其索引到 Qdrant 向量数据库中。该服务器提供了一个工具，可以使用自然语言查询来回答关于文档的问题。

使用示例

# 添加一个专门用于 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. 自动抓取和索引

• 启动时自动抓取: 如果目标站点的内容未被索引或启用了 --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"
      }
    }
    // ... 其他服务器 ...
  }
}

命令行选项

1. 必要参数

• --start-url: 指定抓取的起始 URL。
• --collection-name: 指定 Qdrant 集合的名称。

2. 可选参数

• --depth: 抓取深度，默认为 1。
• --max-links: 最大抓取链接数，默认为 50。
• --exclude-domains: 排除特定域名，以逗号分隔。
• --force-reindex: 强制重新索引已存在的集合。

示例

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

注意事项

• 确保 Qdrant 服务已正确运行，并且可以通过指定的地址访问。
• 如果需要抓取大量内容，建议限制抓取深度和链接数，以避免对目标网站造成压力。
• 使用 --force-reindex 前，请确保目标集合不存在或不再需要其数据。

总结

通过 MCP 服务器 mcp-quant，可以轻松地将指定站点的内容索引到 Qdrant 向量数据库中，并提供自然语言查询功能。该工具支持灵活的配置和扩展，适用于多种文档管理和检索场景。