QV

qpd-v/mcp-ragdocs

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

136 stars 60 forks 质量 70 趋势 16Apache-2.0

qpd-v/mcp-ragdocs 是从 https://github.com/qpd-v/mcp-ragdocs. 导入的 MCP 服务器候选。

概览

qpd-v/mcp-ragdocs 是从 https://github.com/qpd-v/mcp-ragdocs. 导入的 MCP 服务器候选。

概述(AI 翻译)

一个模型上下文协议(MCP)服务器,支持使用向量数据库(Qdrant)进行语义搜索和文档检索。该服务器允许您从URL或本地文件添加文档,然后通过自然语言查询进行搜索。

快速安装指南

  1. 全局安装该软件包:

  2. 启动Qdrant(使用Docker):

  3. 确保 Ollama 运行默认嵌入模型:

  4. 添加到你的配置文件中:

  • 克莱恩:%AppData%\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
  • 对于Roo-Code:%AppData%\Roaming\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
  • 针对Claude桌面版:%AppData%\Claude\claude_desktop_config.json
  1. 验证安装:

版本

当前版本:0.1.6

特色

  • 从URL或本地文件添加文档
  • 将文档存储在语义搜索的矢量数据库中
  • 使用自然语言检索文档
  • 列出所有文档来源

安装

全局使用 npm 安装:

这会将服务器安装到你的全局 npm 目录中,下面配置步骤需要它。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

MCP-Ragdocs

A Model Context Protocol (MCP) server that enables semantic search and retrieval of documentation using a vector database (Qdrant). This server allows you to add documentation from URLs or local files and then search through them using natural language queries.

Quick Install Guide

  1. Install the package globally:

    npm install -g @qpd-v/mcp-server-ragdocs
    
  2. Start Qdrant (using Docker):

    docker run -p 6333:6333 -p 6334:6334 qdrant/qdrant
    
  3. Ensure Ollama is running with the default embedding model:

    ollama pull nomic-embed-text
    
  4. Add to your configuration file:

    • For Cline: %AppData%\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
    • For Roo-Code: %AppData%\Roaming\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
    • For Claude Desktop: %AppData%\Claude\claude_desktop_config.json
    {
      "mcpServers": {
        "ragdocs": {
          "command": "node",
          "args": ["C:/Users/YOUR_USERNAME/AppData/Roaming/npm/node_modules/@qpd-v/mcp-server-ragdocs/build/index.js"],
          "env": {
            "QDRANT_URL": "http://127.0.0.1:6333",
            "EMBEDDING_PROVIDER": "ollama",
            "OLLAMA_URL": "http://localhost:11434"
          }
        }
      }
    }
    
  5. Verify installation:

    # Check Qdrant is running
    curl http://localhost:6333/collections
    
    # Check Ollama has the model
    ollama list | grep nomic-embed-text
    

Version

Current version: 0.1.6

Features

  • Add documentation from URLs or local files
  • Store documentation in a vector database for semantic search
  • Search through documentation using natural language
  • List all documentation sources

Installation

Install globally using npm:

npm install -g @qpd-v/mcp-server-ragdocs

This will install the server in your global npm directory, which you’ll need for the configuration steps below.

Requirements

  • Node.js 16 or higher
  • Qdrant (either local or cloud)
  • One of the following for embeddings:
    • Ollama running locally (default, free)
    • OpenAI API key (optional, paid)

Qdrant Setup Options

Option 1: Local Qdrant

  1. Using Docker (recommended):
docker run -p 6333:6333 -p 6334:6334 qdrant/qdrant
  1. Or download from Qdrant’s website

Option 2: Qdrant Cloud

  1. Create an account at Qdrant Cloud
  2. Create a new cluster
  3. Get your cluster URL and API key from the dashboard
  4. Use these in your configuration (see Configuration section below)

Configuration

The server can be used with both Cline/Roo and Claude Desktop. Configuration differs slightly between them:

Cline Configuration

Add to your Cline settings file (%AppData%\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json) AND/OR

在 GitHub 查看完整 README

安装

docker run -p 6333:6333 -p 6334:6334 qdrant/qdrant
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "ragdocs": { "command": "node", "args": ["C:/Users/YOUR_USERNAME/AppData/Roaming/npm/node_modules/@qpd-v/mcp-server-ragdocs/build/index.js"], "env": { "QDRANT_URL": "http://127.0.0.1:6333", "EMBEDDING_PROVIDER": "ollama", "OLLAMA_URL": "http://localhost:11434" } } } }