KnownPath는 AI 코딩 에이전트를 위한 오픈소스 공유 지식 네트워크입니다. 장기적인 목적은 검증되고 재사용 가능한 엔지니어링 경험을 에이전트 네이티브 인터페이스로 제공하여 에이전트가 동일한 기술 솔루션을 반복적으로 재발견하지 않도록 하는 것입니다.
[!IMPORTANT] KnownPath은(는) 활발하게 단계적으로 개발 중입니다. Phase 13에서는 휴대용 설치 프로그램 CLI와 다섯 가지 코딩 에이전트용 안전한 어댑터를 추가합니다. 기여/성과 도구, 대시보드, 공개 가입, 공개 익명 접근은 아직 구현되지 않았습니다. 설치 프로그램은
knownpath로 게시됩니다.
Node.js 24 LTS (.nvmrc가 지원되는 주 버전을 추적하며, package.json이 테스트된 범위를 적용합니다)
지원되는 Node.js 배포판에 포함된 Corepack
로컬 MongoDB용 Compose를 지원하는 Docker Desktop 또는 다른 Docker Engine
Related MCP server: CodeGraph
corepack enable
pnpm install
cp .env.example .env.env.example에 설명된 대로 독립적인 BETTER_AUTH_SECRET 및 API_KEY_PEPPER 값을 생성하세요. 커밋된 예시에는 자격 증명의 기본값이 들어 있지 않습니다.
MongoDB 시작:
pnpm dev:infra현재 콜렉션, 검증기, 인덱스를 생성하거나 재조정합니다:
pnpm db:init선택적 영속성 검사 및 저장소 왕복 검증:
pnpm db:inspect
pnpm db:verify마스킹된 CLI를 통해 첫 번째 로컬 사용자 또는 관리자를 생성합니다(가입은 닫혀 있음):
pnpm auth:user:create선택적으로 .env에 GITHUB_TOKEN을 설정하여 일반적인 5,000-요청 인증 REST 제한 및 GitHub Discussions 접근을 얻으세요. 그런 다음 제한된 수집을 미리 보거나 실행합니다:
pnpm ingest:github --source expo-core --types issues --limit 5 --dry-run
pnpm ingest:github --source expo-core --types issues --limit 5백필을 실행하기 전에 GitHub 수집 가이드를 확인하세요.
소스 레코드를 기록하지 않고 현재 선별된 공식 문서 세트를 발견한 다음, 제한된 소스 또는 색인된 페이지 하나를 동기화합니다:
pnpm ingest:sources discover --source expo-documentation --limit 20
pnpm ingest:sources sync --source expo-documentation --limit 5 --dry-run
pnpm ingest:sources sync --source expo-documentation \
--page https://docs.expo.dev/workflow/upgrading-expo-sdk-walkthrough --limit 1큐레이션을 변경하거나 제한된 전체 카탈로그 실행을 요청하기 전에 공식 소스 수집 가이드를 읽으세요.
무시되는 .env에 Gemini 개발 키를 설정하고 제한된 공개 소스 후보를 처리하거나 검사합니다:
pnpm extract one --source-item <uuid>
pnpm extract pending --limit 5
pnpm extract inspect --attempt <uuid>
pnpm extract inspect --candidate <uuid>무료 Gemini 경로는 공급자 호출 전에 개인/팀 소스 레코드를 강력하게 거부합니다. 키를 구성하거나 배치를 확장하기 전에 AI 추출 가이드를 읽으세요.
AI 공급자를 호출하지 않고 추출된 후보에 점수를 매긴 다음 전체 분류/이력을 검사합니다:
pnpm score one --candidate <uuid>
pnpm score pending --limit 10
pnpm score inspect --assessment <uuid>
pnpm score history --candidate <uuid>점수는 설명 가능한 순위 신호일뿐 실제 확률은 아닙니다. 버전이 있는 정책을 변경하기 전에 점수 부여 가이드를 읽으세요.
불변 유사도 프로파일을 신축하고, 차단된 쌍을 발견하며, 리뷰를 검사하고, 결정론적으로 안전한 정규 병합만 적용합니다:
pnpm canonicalize profile --limit 10
pnpm canonicalize discover --limit 10
pnpm canonicalize review --limit 20
pnpm canonicalize auto-merge --limit 10 # dry-run
pnpm canonicalize auto-merge --limit 10 --apply
pnpm canonicalize history --known-path <uuid>Gemini 임베딩은 후보와 참조된 모든 소스가 공개로 확인된 후에만 생성됩니다. 지금은 적절성 있는 차단 비교를 지원하지만 상태적인 병합을 자동으로 결정하지 않습니다. 병합이나 수동 조작을 적용하기 전에 정준화 가이드를 읽으세요.
현재 정규 검색 프로젝션을 구축하고 로컬에서 쿼리합니다. 검토 상태의 레코드는 명시적으로 요청하지 않으면 제외됩니다:
pnpm run search project --pending --limit 10
pnpm run search query --text "EAS build cannot find an imported file" \
--error "None of these files exist" --ecosystem expo --include-review
pnpm run search indexes print로컬 MongoDB는 정확/오류 및 가중-텍스트 검색을 사용하며, 의미 검색은 사용할 수 없다고 명확히 보고합니다. Atlas Search/Vector Search는 선택적 구성입니다. 유료 Gemini 공급자는 개인/팀 문서 및 쿼리 텍스트를 강력하게 거부합니다. Atlas 또는 랭킹/모델 구성을 활성화하기 전에 검색 가이드를 읽으세요.
모든 응용 프로그램 및 패키지 개발 프로세스를 시작합니다:
pnpm dev현재 웹 셸은 http://127.0.0.1:3000에서 서빙됩니다. API 활성 및 준비 상태는 http://127.0.0.1:3001/health/live 및 http://127.0.0.1:3001/health/ready에서 확인할 수 있습니다. OpenAPI JSON은 http://127.0.0.1:3001/api/v1/openapi.json에 있으며 개발 Swagger UI는 http://127.0.0.1:3001/docs/에 있습니다.
인증된 지식 검색, 정규 세부 정보, 대안, 리뷰 접근 규칙 및 안전한 컬 curl 예제는 Knowledge HTTP API 가이드에 문서화되어 있습니다. 일반 클라이언트는 공개된 게시된 레코드만 받으며, 리뷰 접근은 명시적이고 관리 키 전용이며 감사됩니다.
빌드 후 MCP 클라이언트를 http://127.0.0.1:3001/mcp에 직접 연결하거나 KNOWNPATH_API_URL 및 KNOWNPATH_API_KEY 로 얇은 stdio 브리지를 실행합니다:
pnpm mcp:stdio
pnpm mcp:inspect --transport stdio도구 계약, 인증, 보안 동작 및 현재 Codex/Claude Code/Cursor/Gemini CLI 구성은 MCP 가이드에 문서화되어 있습니다.
휴대 가능한 Agent Skill는 지원되는 코딩 에이전트가 획득한 수정을 맹목적으로 적용하지 않고 해당 MCP 도구를 언제/어떻게 어떻게 사용할지 안내합니다. 수동 개발 설치 및 현재 동작 계약은 Agent Skill 가이드에 설명되어 있습니다.
각 에이전트를 시작하는 환경에서 API 원본과 API 키를 구성한 다음 Phase 13 설치 계획을 검사하거나 적용합니다:
export KNOWNPATH_API_URL='https://your-knownpath-origin.example'
read -rsp 'KnownPath API key: ' KNOWNPATH_API_KEY && export KNOWNPATH_API_KEY && printf '\n'
pnpm knownpath -- install --dry-run --agent all
pnpm knownpath -- install --agent all
pnpm knownpath -- doctor --agent allCLI는 해당 변수 이름에 대한 참조만 저장하며 URL에 대체 항목이 없습니다. Codex CLI, Clop Code, Cursor, Gemini CLI, OpenCode를 전역 또는 프로젝트 범위에서 지원합니다. 사용자는 npx knownpath install를 실행할 수 있고, 저장소 개발에서는 pnpm knownpath --을 사용할 수 있습니다. 정확한 변경, Windows 설정, 백업, 충돌, 업데이트 및 제거 동작은 설치 프로그램 가이드에 문서화되어 있습니다.
루트 render.yaml은 Fastify API에 대한 하나의 Render 웹 서비스를 정의하고 MongoDB Atlas를 데이터베이스로 유지합니다. 의도적으로 worker, 대시보드 또는 다른 데이터스토어를 배포하지 않습니다. 설정 전에 이전에 노출된 자격 증명을 순환시키고, Render 배포 가이드의 안내에 호스트 Blueprint, Atlas 방화벽 액세스, 헬스 확인, 배포 후 API 키 흐름을 따라 진행합니다.
MongoDB의 지정된 개발 볼륨을 삭제하지 않고 중지합니다:
pnpm dev:infra:down명령어 | 설명 |
| 고정된 작업 공간 의존성 설치 |
| 작업 공간 개발 작업 실행 |
| 컴파일 가능한 모든 앱 및 패키지 빌드 |
| 작업 공간 전반의 엄격한 TypeScript 검증 실행 |
| 작업 공간 전반에 ESLint 플랫 구성 실행 |
| Prettier로 지원되는 파일 형식 선정 |
| 파일을 변경하지 않고 형식 검증 |
| 필요한 로컬 MongoDB 컨테이너를 시작합니다 |
| 데이터 볼륨을 보존하면서 로컬 컨테이너 중지 |
| MongoDB 컬렉션, 검증기 및 인덱스를 상태에 맞게 생성/제거 |
| 현재 컬렉션 검증기 및 인덱스 출력 |
| 저장소 지속성 왕복 실행 및 정리 |
| 마스킹된 비밀번호 프롬프트로 사용자/관리자 안전하게 생성 |
| 공식 API를 통해 제한된 구성된 GitHub 소스를 수집 |
| 구성된 공식 문서 및 릴리스 피드를 발견하거나 동기화 |
| 제한된 공개 소스 후보 요약을 추출 또는 검사 |
| 증거를 검증하고 불변 후보 평가를 생성/검사 |
| 후보를 프로파일링, 비교, 검토, 병합, 분리, 재할당 또는 재구축 |
| 정규화된 KnownPaths를 프레젠트, 임베드, 인덱스,검사 또는 쿼리 |
| stdio에서 간단한 로컬 MCP-to-HTTP 브리지 실행 |
| 공식 SDK 클라이언트로 MCP 도구 나열 또는 호출 |
| 이 체크아웃에서 멀티 에이전트 설치 CLI 실행 |
apps/
api/ Fastify HTTP process
cli/ Publishable installer CLI and stdio bridge entry point
mcp-server/ Thin stdio MCP bridge to the authenticated HTTP API
web/ Next.js application shell
worker/ Source ingestion and future background processing runtime
packages/
agent-adapters/ Safe detection/configuration adapters and ownership state
ai/ Gemini provider, privacy gate, prompts, validation, and extraction lifecycle
auth/ Sessions, API keys, principals, authorization, and audit
config/ Typed environment parsing
database/ MongoDB lifecycle, repositories, validators, and indexes
domain/ Versioned domain schemas and canonicalization helpers
canonicalization/ Deterministic blocking, optional embeddings, and canonical projections
github-ingestion/ GitHub API collection and source normalization
source-ingestion/ Official documentation/feed discovery and normalization
verification/ Deterministic evidence verification and immutable seed scoring
search/ Embeddings, search projections, hybrid retrieval, and explainable ranking
mcp/ Shared MCP tool contracts, projections, server factory, and HTTP gateway
typescript-config/ Shared strict compiler configurations
skills/
knownpath/ Portable Agent Skill instructions and on-demand examples현재 경계와 전달 상태는 아키텍처 가이드와 데이터 모델, 검색 가이드, Knowledge HTTP API 가이드, MCP 가이드, Agent Skill 가이드, 설치 프로그램 가이드, 배포 가이드, 결정 로그 및 단계 진행을 참조하세요.
KnownPath는 Apache License 2.0에 따라 사용이 허가됩니다.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Shared, peer-validated knowledge archive for AI agents — search, contribute, and validate via MCP
Your memory, everywhere AI goes. Build knowledge once, access it via MCP anywhere.
Persistent memory and cross-session learning for AI coding assistants (hosted remote MCP).
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/nasyx-rakeeb/knownpath'
If you have feedback or need assistance with the MCP directory API, please join our Discord server