MCP Ragdocs

🚀 RAG 文档 MCP 服务器

RAG 文档 MCP 服务器是一个实现的 MCP 服务器，它能提供文档检索和处理功能，并借助向量搜索提供工具支持。这使得 AI 助手可以利用相关文档上下文来增强其响应内容，提升回答的准确性和全面性。

✨ 主要特性

• 🔍 基于向量的文档搜索和检索：利用向量技术高效查找所需文档。
• 🌐 支持多个文档来源：可整合不同渠道的文档资源。
• 📖 语义搜索功能：理解查询语义，精准定位相关文档。
• 🤖 自动化文档处理：提高文档处理效率。
• 💪 实时上下文增强 LLM 能力：让大语言模型的响应更具针对性。

🛠️ 工具

search_documentation

通过自然语言查询在存储的文档中进行搜索。返回匹配的摘录及其上下文，按相关性排序。

• 输入：
  • query (字符串)：要在文档中搜索的文本。可以是自然语言查询、特定术语或代码片段。
  • limit (数字，可选)：要返回的结果的最大数量（1 - 20，默认值：5）。较大的限制会提供更多全面的结果，但可能会增加处理时间。

list_sources

列出当前存储在系统中的所有文档来源。返回一个详尽的列表，包括所有索引的文档源 URL、标题和最后更新时间。使用此工具可了解可用以搜索的文档内容，或验证是否已索引特定来源。

extract_urls

从指定网页中提取并分析所有 URL。此工具爬取指定网页、识别所有超链接，并可选择将它们添加到处理队列中进行后续处理。

• 输入：
  • url (字符串)：要分析的网页完整 URL（必须包含协议，例如 https://）。该页面必须公开可访问。
  • add_to_queue (布尔值，可选)：如果为 true，则自动将提取的 URL 添加到处理队列中进行后续索引。在大型网站上使用时请谨慎以避免队列过多。

remove_documentation

通过其 URL 从系统中永久删除特定文档来源。此操作会影响未来的搜索结果。

• 输入：
  • urls (字符串数组)：要从数据库中移除的 URL 列表。每个 URL 必须与添加时使用的 URL 完全匹配。

list_queue

列出当前在文档处理队列中等待的所有 URL。显示待处理文档来源，这些将在调用 run_queue 时进行处理。使用此工具可监控队列状态、验证 URL 是否正确添加，或检查处理 backlog。

run_queue

处理并索引所有当前位于文档处理队列中的 URL。每个 URL 将按顺序处理，并提供适当的错误处理和重试逻辑。在处理过程中会提供进度更新。长时间运行的操作将在队列清空或发生不可恢复的错误之前继续进行。

clear_queue

从文档处理队列中移除所有待处理 URL。使用此工具可开始清空队列、移除不需要的 URL，或取消待处理任务。此操作是立即且永久的 - 如果需要再次处理这些 URL，则需要重新添加它们。

💻 使用示例

搜索文档

输入：

{
    "query": "如何配置 RAG 文档工具？",
    "limit": 5
}

输出：

[
    {"content": "步骤 1：安装所需的依赖项。", "source": "documentation/installation.md"},
    {"content": "步骤 2：配置环境变量。", "source": "documentation/configuration.md"},
    {"content": "步骤 3：启动服务。", "source": "documentation/getting-started.md"}
]

列出来源

输入：

{
    "input": "None"
}

输出：

[
    {"url": "documentation/installation.md", "title": "安装指南", "last_updated": "2024-01-01"},
    {"url": "documentation/configuration.md", "title": "配置指南", "last_updated": "2024-01-02"}
]

提取 URL

输入：

{
    "url": "https://example.com/documentation",
    "add_to_queue": true
}

输出：

{
    "status": "success",
    "message": "URL 已添加到队列中。"
}

⚙️ 配置

与 Claude Desktop 结合使用

在 claude_desktop_config.json 文件中添加以下内容：

{
    "MCP server": {
        "enabled": true,
        "configuration": {
            "type": "RAGDocumentation"
        }
    }
}

🌐 环境变量

此文档详细描述了 RAG 文档 MCP 服务器的功能、工具和配置。通过结合这些功能，您可以有效地管理和检索文档内容以支持 AI 应用程序。