seojae-mcp

# 서재 (Seojae) **폴더에 문서를 꽂아두면 Claude가 꺼내 읽는 로컬 RAG MCP 서버.** 문서를 폴더에 정리해두면 자동으로 색인해서 MCP로 노출한다. Claude가 질문에 맞는 책장을 골라 검색하고, **출처(파일·위치)를 붙여** 답한다. ``` 질문: "예외 처리 규약이 어떻게 되지?" Claude → search(query="예외 처리 규약", collection="개발가이드") ← 3건, 각각 출처 포함 답변: 업무예외는 DefaultApplicationException으로 던진다. (출처: 개발가이드/아키텍처.md · "예외 처리" 절) ``` 문서는 **PC를 떠나지 않는다.** 네트워크 전송 없음, 외부 API 호출 없음, 계정 없음. > [!NOTE] > 개발 중이다. 6단계 중 5단계까지 동작한다. 아래 [진행 상태](#진행-상태) 참고. --- ## 이 프로젝트가 LLM을 부르지 않는 이유 RAG는 **R**etrieval(검색)과 **G**eneration(생성)으로 나뉜다. 보통은 도구가 둘 다 하지만, 서재는 **검색만 한다.** | | 하는 일 | 누가 | |---|---|---| | **R** | 색인·검색·출처 | 서재 (로컬) | | **G** | 답변 생성 | 사용자의 Claude | 생성을 사용자의 LLM에 맡기면 세 가지가 따라온다. - **비용 0** — 내가 낼 API 요금이 없다. 사용자도 이미 내고 있는 구독을 그대로 쓴다 - **유출 0** — 문서가 내 서버로 갈 일이 없다. 애초에 서버가 없다 - **모델 선택 자유** — 사용자가 쓰는 모델이 곧 이 도구의 성능이다 같은 원리를 **분류**에도 적용한다. 미분류 파일을 어느 책장에 꽂을지 판단하는 것도 LLM의 일이지만, 서재는 판단하지 않는다. **읽을 재료(본문 발췌)와 옮기는 손(파일 이동)만 제공하고, 판단은 사용자의 Claude가 한다.** --- ## 도서관 비유 | 도서관 | 서재 | |---|---| | 반납대·미정리 도서 | `_inbox\` 미분류 파일 | | 사서가 분류해 배가 | Claude가 판단 → `file_document`가 실제 이동 | | 서가·청구기호 | 컬렉션 폴더 + `README.md` 프론트매터 | | 열람 요청 | `search` / `get_document` (출처 포함) | | **도서관 이용자** | **AI (사용자의 Claude)** | 사서도 손님도 AI지만, **서고와 목록은 로컬에 있다.** --- ## 폴더 구조가 곧 지식베이스 설계다 루트 폴더 하나를 지정한다. 그 **바깥은 어떤 경우에도 읽지 않는다.** ``` 내서재\ ├── 업무규정\ ← 컬렉션 (책장) │ ├── README.md ← 이 책장이 무엇인지 (라우팅 근거) │ ├── 취업규칙.pdf │ └── 경비\ │ └── 출장비지침.docx ← 하위 폴더도 같은 책장으로 색인 ├── 개발가이드\ │ ├── README.md │ └── 아키텍처.md └── _inbox\ ← 미분류 투입구. 일단 여기 던져둔다 └── 어제받은문서.pdf ``` 각 책장의 `README.md` 프론트매터가 그 책장의 정의다. ```markdown --- name: 업무규정 description: 회사 취업규칙과 경비 지침. 휴가·출장비·근무시간 질문에 사용. tags: [규정, 총무] --- # 업무규정 - 취업규칙.pdf — 근로조건 정본 ``` `description`은 "**어떤 질문에 이 책장을 써야 하는지**"를 적는다. 이 문장이 서버 instructions로 주입돼서, Claude가 검색 전에 **어느 서랍을 열지 먼저 고른다.** README가 없으면 폴더명·파일명·헤딩으로 자동 생성한다 (동작은 항상 되게). --- ## 다른 로컬 RAG MCP 서버와 뭐가 다른가 "로컬 폴더를 RAG로 색인해 M…