벡터 데이터베이스(Qdrant)를 이용한 의미론적 검색과 문서 검색을 가능하게 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 URL이나 로컬 파일에서 문서를 추가한 후 자연어 쿼리를 통해 검색할 수 있게 해줍니다.

빠른 설치 가이드

1. 패키지를 전역적으로 설치하기:

2. Qdrant 시작 (도커 사용):

3. Ollama가 기본 임베딩 모델로 실행되는지 확인하세요:

4. 설정 파일에 추가:

• 클라인을 위해: %AppData%\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
• 루코드의 경우: %AppData%\Roaming\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
• 클로드 데스크톱용: %AppData%\Claude\claude_desktop_config.json

5. 설치 확인:

버전

현재 버전: 0.1.6

특징

• URL 또는 로컬 파일에서 문서 추가
• 의미 검색을 위한 벡터 데이터베이스에 문서를 저장
• 자연어를 이용한 문서 검색
• 모든 문서 출처 목록

설치

npm을 사용해 전역적으로 설치하기:

이렇게 하면 서버를 전역 npm 디렉터리에 설치하게 되며, 아래 설정 단계에서 필요합니다.

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

2. 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