mcp-qdrant-server-with-qdrant-db

mcp-qdrant-server-with-qdrant-db

3.2

If you are the rightful owner of mcp-qdrant-server-with-qdrant-db and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This project integrates Qdrant vector database with an MCP server to store and retrieve code snippets.

MCP Server with Qdrant

이 ν”„λ‘œμ νŠΈλŠ” Qdrant 벑터 λ°μ΄ν„°λ² μ΄μŠ€μ™€ MCP(Model Control Protocol) μ„œλ²„λ₯Ό ν†΅ν•©ν•˜μ—¬ μ½”λ“œ μŠ€λ‹ˆνŽ«μ„ μ €μž₯ν•˜κ³  검색할 수 μžˆλŠ” μ‹œμŠ€ν…œμž…λ‹ˆλ‹€.

κΈ°λŠ₯

  • μ½”λ“œ μŠ€λ‹ˆνŽ« μ €μž₯ 및 관리
  • μžμ—°μ–΄ 기반 μ½”λ“œ 검색
  • μ‹œλ§¨ν‹± 검색을 ν†΅ν•œ κ΄€λ ¨ μ½”λ“œ 쑰회
  • SSE(Server-Sent Events) 전솑 방식 지원

μ‹œμŠ€ν…œ ꡬ성

  • Qdrant: 벑터 λ°μ΄ν„°λ² μ΄μŠ€ μ„œλ²„ (포트: 6333, 6334)
  • MCP Server: μ½”λ“œ μŠ€λ‹ˆνŽ« 관리 μ„œλ²„ (포트: 8000)
  • μž„λ² λ”© λͺ¨λΈ: (default)sentence-transformers/all-MiniLM-L6-v2

MCP Tools

QDRANT MCP μ„œλ²„λŠ” λ‹€μŒκ³Ό 같은 도ꡬ듀을 μ œκ³΅ν•©λ‹ˆλ‹€:

1. qdrant-store

  • κΈ°λŠ₯: Qdrant λ°μ΄ν„°λ² μ΄μŠ€μ— 정보λ₯Ό μ €μž₯
  • μž…λ ₯:
    • information (string): μ €μž₯ν•  정보
    • metadata (JSON): 선택적 메타데이터
  • λ°˜ν™˜: μ €μž₯ 확인 λ©”μ‹œμ§€

2. qdrant-find

  • κΈ°λŠ₯: Qdrant λ°μ΄ν„°λ² μ΄μŠ€μ—μ„œ κ΄€λ ¨ 정보λ₯Ό 검색
  • μž…λ ₯:
    • query (string): 검색에 μ‚¬μš©ν•  쿼리
  • λ°˜ν™˜: Qdrant λ°μ΄ν„°λ² μ΄μŠ€μ— μ €μž₯된 정보λ₯Ό κ°œλ³„ λ©”μ‹œμ§€λ‘œ λ°˜ν™˜

μ‹œμž‘ν•˜κΈ°

ν•„μˆ˜ 쑰건

  • Docker
  • Docker Compose

μ„€μΉ˜ 및 μ‹€ν–‰

1. μ €μž₯μ†Œ 클둠
git clone <repository-url>
cd <repository-name>
2. μ„œλΉ„μŠ€ μ‹œμž‘
docker-compose up -d
3. μ„œλΉ„μŠ€ μƒνƒœ 확인
docker-compose ps

μ„œλΉ„μŠ€ μ ‘κ·Ό

    "qdrant": {
      "url": "http://localhost:8000/sse"
    },

ν™˜κ²½ λ³€μˆ˜

Qdrant

  • RUST_LOG: λ‘œκΉ… 레벨 (κΈ°λ³Έκ°’: info)

MCP Server

  • QDRANT_URL: Qdrant μ„œλ²„ μ£Όμ†Œ
  • COLLECTION_NAME: μ»¬λ ‰μ…˜ 이름
  • EMBEDDING_MODEL: μž„λ² λ”© λͺ¨λΈ
  • TOOL_STORE_DESCRIPTION: μ €μž₯ 도ꡬ μ„€λͺ…
  • TOOL_FIND_DESCRIPTION: 검색 도ꡬ μ„€λͺ…

데이터 μ €μž₯

λ°μ΄ν„°λŠ” ./qdrant_storage 디렉토리에 영ꡬ적으둜 μ €μž₯λ©λ‹ˆλ‹€.

μ„œλΉ„μŠ€ 관리

둜그 확인

docker-compose logs -f

μ„œλΉ„μŠ€ 쀑지

docker-compose down

μ£Όμ˜μ‚¬ν•­

  • 데이터 백업을 μœ„ν•΄ qdrant_storage 디렉토리λ₯Ό 주기적으둜 λ°±μ—…ν•˜μ„Έμš”.
  • ν”„λ‘œλ•μ…˜ ν™˜κ²½μ—μ„œλŠ” μ μ ˆν•œ λ³΄μ•ˆ 섀정을 μΆ”κ°€ν•˜μ„Έμš”.