local-rag-wiki

AI 에이전트를 위한 리포지토리 로컬 RAG 위키: 리포지토리별 MCP 지식 서비스(Markdown 위키 노트의 관리형 검색/읽기/쓰기)와 이를 에이전트 도구에 연결하는 설치 프로그램입니다. 서비스를 실행하려면 Docker가 필요합니다.

빠른 시작(권장)

콜드 스타트 지연을 피하려면 첫 에이전트 세션 전에 서비스 이미지를 미리 받아두세요:

docker pull ihorleleka/project-rag-wiki:latest

Related MCP server: hw_rag_mcp

설치

리포지토리 루트에서 실행하세요:

npx github:ihorleleka/Local-Rag-Wiki install .

이 명령은 관리되는 .agents/ 러너, AGENTS.md 정책 섹션, DeepSeek Harness(.dsh/mcp.servers.yml), Claude Code, Codex, VS Code, OpenCode용 MCP 구성, 그리고 wiki/ 폴더를 생성합니다. 이러한 통합은 추가 방식입니다. DSH 지원을 설치해도 다른 하네스 구성이 제거되거나 대체되지 않습니다. 그러면 에이전트 클라이언트가 연결될 때 MCP 서비스가 리포지토리별로 자동으로 시작됩니다. 새 환경에서 에이전트를 실행하기 전에 (위의) 이미지 미리 받기를 권장합니다.

DeepSeek Harness

사용하는 프로필(보통 web)에 네이티브 DSH 번들을 한 번 설치하세요:

dsh plugin --profile web add github:ihorleleka/Local-Rag-Wiki

해당 DSH 프로필을 다시 시작하고, 설치된 리포지토리를 작업 공간으로 연 다음 세션을 시작하세요. agent/created에서 번들은 에이전트의 실제 작업 공간(사용자 지정 --agents-dir 포함)을 사용하여 DSH 공식 @deepseek-ai/dsh-mcp-client를 마운트하고, 관리되는 MCP 러너를 시작한 뒤 다시 연결하고, 도구를 발견하여 예측 가능한 mcp__wiki-manager__* 도구를 등록합니다. 네임스페이스는 안정적이지만 클라이언트는 에이전트 범위로 유지됩니다. 러너는 다른 하네스에서와 똑같이 해당 리포지토리의 Docker 서비스를 시작하거나 연결합니다.

또한 해당 작업 공간에 마커로 제어되는 Cordis 리콜 코디네이터를 마운트합니다. agent/session-start는 반복 주제 힌트를 시드하고, agent/pre-step은 로컬 상태를 사용한 다음 실질적인 프롬프트에 대해서만 제한된 위키 검색을 수행합니다. 먼저 wiki_search depth="abstract"(L0), 그다음 일치하는 depth="packet" 컨텍스트(L1)입니다. 증거에 레이블을 붙이고 전체 L2 wiki_read 결정은 모델에 맡깁니다. session/event는 어시스턴트 요약을 기록하고, agent/turn-stopping과 session/flush는 상태를 정리하고 유지합니다. 리콜은 작업 공간별로 캐시되고 진행 중 중복은 제거됩니다. L1 패킷은 속도가 제한되고, 콜드 스타트에는 90초로 제한된 허용 시간이 있으며, 상태 업데이트는 원자적 교체로 큐에 대기됩니다. wiki-kit 설치 마커가 있는 리포지토리 밖에서는 어떤 상태나 위키 프로세스도 사용되지 않습니다.

생성된 .dsh/mcp.servers.yml은 작업 공간 구성 대안으로 남아 있습니다. 두 브리지를 모두 실행하면 동일한 리포지토리 서비스에 대한 MCP 연결이 두 개 생기므로 프로필 번들을 선호하세요. AGENTS.md는 이식 가능한 정책 계층으로 유지됩니다.

.agents/hooks/ 및 .claude/settings.local.json 후크는 Claude Code 전용입니다. DSH 수명 주기 가로채기는 프로젝트 로컬 후크 매니페스트가 아니라 신뢰할 수 있는 Host/Profile Cordis 플러그인에 속합니다. 작업 공간 구성 경계는 .dsh/README.md를 참조하세요.

업데이트

설치 후 리포지토리 내부에서 관리 파일을 새로고침하세요. npx는 필요 없습니다:

.agents\update-wiki-kit.cmd --force

sh .agents/update-wiki-kit.sh --force

수명 주기

npx github:ihorleleka/Local-Rag-Wiki status .
npx github:ihorleleka/Local-Rag-Wiki restart .
npx github:ihorleleka/Local-Rag-Wiki doctor . --live

start ., stop ., pull .도 같은 방식으로 사용할 수 있습니다. 리포지토리 컨테이너는 개별 에이전트 클라이언트와 독립적으로 유지됩니다.

작동 방식

• 이 패키지는 설치 프로그램입니다. 소비자 리포지토리에서 .agents/ 러너와 MCP 구성을 생성하고 유지 관리합니다.

• kb-service/는 러너가 리포지토리별로 시작하는 Docker화된 MCP 지식 서비스입니다. 해시로 보호되는 쓰기와 함께 POST /mcp/(기본적으로 루프백)를 통해 wiki_search, wiki_read, wiki_list, wiki_tree, wiki_schema_report, wiki_write, wiki_capture, wiki_delete, wiki_rename을 제공합니다. wiki_search는 계층형 검색(depth=abstract|packet)과 path_prefix 디렉터리 범위 지정을 지원합니다.

버전 관리

설치 프로그램과 kb-service는 동일한 Git 태그(X.Y.Z 또는 vX.Y.Z)를 사용합니다. 릴리스 자동화:

• tag-version-verify.yml

• docker-release.yml

라이선스

MIT (자세한 내용은 kb-service/LICENSE 참조).