Skip to main content
Glama

glowfic-rag

glowfic.com 콘텐츠에 대한 의미론적 검색을 제공하며, Claude Code 및 Cursor를 위한 MCP 서버로 노출됩니다.

ChromaDB에 저장된 GTE-Large 임베딩을 사용합니다. 사전 구축된 인덱스는 다음 게시판의 약 65만 8천 개의 게시물을 포함합니다:

  • planecrash (게시판 215) — 1만 9천 개 게시물, 28개 스레드

  • Sandboxes (게시판 3) — 63만 9천 개 게시물, 2,214개 스레드

  • trainwreck (게시판 277) — 595개 게시물, 7개 스레드

게시판 구조 가져오기(src/render.py, src/auth.py)는 Roger CurleyAlyssa Riceman이 제작한 rocurley/glowfic-dl에서 파생되었습니다.

빠른 시작

**Python 3.10+**가 필요합니다 (mcp 패키지에 필요).

git clone https://github.com/keenanpepper/glowfic-rag.git
cd glowfic-rag

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Download the pre-built vector database (~2GB compressed, ~5GB on disk)
./setup_data.sh

Related MCP server: MCP Codebase RAG Server

Claude Code와 함께 사용하기

이 저장소에는 Claude Code가 자동으로 감지하는 .mcp.json이 포함되어 있습니다. 저장소 디렉토리에서 다음을 실행하세요:

claude

Claude는 search_glowficlist_indexed_continuities 도구에 액세스할 수 있게 됩니다.

Cursor와 함께 사용하기

복제본의 절대 경로를 사용하여 .cursor/mcp.json을 생성하세요:

{
  "mcpServers": {
    "glowfic-search": {
      "command": "/path/to/glowfic-rag/.venv/bin/python3",
      "args": ["-m", "rag.mcp_server"],
      "cwd": "/path/to/glowfic-rag"
    }
  }
}

그런 다음 Cursor 창을 새로고침하세요.

CLI 검색

명령줄에서 직접 검색할 수도 있습니다:

python -m rag.search "Keltham explains expected utility" -k 5
python -m rag.search "vampire meets werewolf" --continuity Sandboxes
python -m rag.search "dath ilan" --author Iarwain

더 많은 연속성 추가하기

게시판을 JSONL로 스크랩한 다음 인덱스에 추가하세요:

# Scrape (supports --resume for interrupted runs)
python -m rag.scrape https://glowfic.com/boards/277

# Index (adds to existing collection, doesn't rebuild)
python -m rag.index data/trainwreck.jsonl

# Or reindex everything from scratch
python -m rag.index --reset

스크레이퍼는 대규모 게시판에 대한 페이지 매김을 처리하며, 제한된 요청을 자동으로 재시도합니다.

성능 참고 사항

  • 첫 번째 쿼리: 약 10초 (모델 로드 + 인덱스 예열)

  • 이후 쿼리: 1초 미만

  • 메모리: 모델 및 인덱스 로드 시 약 3~5GB

  • 디스크: ChromaDB 인덱스용 약 5GB

Related MCP Connectors

Related MCP Servers