어떻게 쓰나요?
- 1위 내려받기를 누르면 GitHub 릴리스 페이지가 열립니다. 맨 위 최신 항목의 파일을 받으세요.
- 2안내에 따라 설치하고 실행합니다.
- 3쓰다가 막히면 아래 이야기에 남겨 주세요. 만든 사람이 직접 답합니다.
For developers
개발자 정보
기술 스택 · 시스템 구조 · 기술 과제 — 필요한 항목만 눌러서 펼쳐 보세요
프로젝트 요약 규모 · 배포 · 해결한 문제
| 규모 | 1인 개발 |
|---|---|
| 배포 | GitHub |
| 해결한 문제 | AI가 만든 코드를 내 PC와 분리된 자리에서 실행하게 한다 |
네이티브 의존성을 두지 않았습니다. 빌드 도구가 없는 Windows PC에서도 설치가 그냥 끝나야 하기 때문입니다.
기술 스택 무엇을 왜 골랐나
TypeScriptNode.jsMCP SDK
TypeScript오버레이·MCP 서버처럼 오래 떠 있는 프로그램에 씁니다. 설정 스키마에 타입을 걸어 값이 어긋나면 빌드에서 잡히게 합니다.
시스템 구조 모듈 · 데이터 흐름
실행
일회용 프로세스js · python · shell을 따로 띄운 프로세스에서 돌리고 끝나면 버립니다.
셸 자동 탐지PowerShell 7 계열과 Git Bash를 여러 설치 경로에서 찾고, 없으면 cmd로 내려갑니다.
색인
본문만 추출웹 페이지를 받아 태그를 벗기고 1500자 정도로 잘라 저장합니다.
내장 SQLiteNode 22에 들어온 SQLite를 씁니다. 따로 빌드할 네이티브 모듈이 없습니다.
조회
조각 검색질의에 맞는 조각만 돌려줍니다. 원문 전체가 대화에 들어오지 않습니다.
파일 다섯 개, 각 100줄 이하의 서버 하나입니다. 백그라운드 데몬을 두지 않아 안 죽은 프로세스가 쌓이지 않습니다.
인터페이스 · 설정 구조 설정 스키마
MCP 서버가 내보내는 도구 다섯 개입니다. 지식베이스는 플러그인 데이터 폴더에 저장돼 업데이트해도 남습니다.
| 키 | 타입 | 기본값 | 설명 |
|---|---|---|---|
exec_code | language, code, timeout_ms? | — | 코드 한 조각을 격리된 프로세스에서 실행 |
exec_batch | commands[] | 동시 4개 · 2분 | 여러 조각을 한 번에 병렬 실행 |
fetch_index | url, source? | — | 웹 페이지를 받아 지식베이스에 넣기 |
search | queries[], source?, limit? | — | 지식베이스에서 맞는 조각 찾기 |
kb_stats | () | — | 넣어 둔 출처와 조각 수 보기 |
기술 과제와 해결 막혔던 지점
과제 01SQLite를 쓰려면 보통 네이티브 모듈을 빌드해야 합니다. 빌드 도구가 없는 Windows PC에서는 설치가 거기서 멈춥니다.
Node 22에 들어온 내장 SQLite를 씁니다. 네이티브 의존성이 하나도 없어 설치가 그냥 끝납니다.
과제 02문서를 참고시키려고 웹 페이지를 통째로 넣으면 원문이 대화 창을 다 차지합니다. 정작 필요한 것은 몇 줄인데도 그렇습니다.
받은 페이지를 잘라 색인해 두고 검색할 때 맞는 조각만 돌려줍니다. 원문 자체는 대화에 들어오지 않습니다.
과제 03Windows는 사람마다 셸이 다릅니다. PowerShell 7이 있기도 하고 Git Bash만 있기도 합니다.
설치 경로 여러 곳을 순서대로 찾아보고, 그래도 없으면 cmd로 내려가 실행합니다.
쓰는 사람들 이야기
읽는 것은 로그인 없이 됩니다. 글을 남기려면 한 번만 로그인해 주세요 — 가입 절차는 없습니다.
이름과 프로필 사진만 가져옵니다. 따로 입력하실 것은 없습니다.
이 도구에 대한 이야기가 아직 없습니다. 첫 글을 남겨주세요.