bun-docs-toolkit

AI 에이전트를 위한 항상 최신 상태의 Bun 문서 — bun-types에서 직접 가져오므로 프로젝트에서 사용하는 Bun 버전에 맞춰 고정됩니다.

왜?

기존의 "AI 에이전트용 Bun 문서" 프로젝트는 모두 특정 시점의 Bun 문서를 포크하거나 복제한 뒤 오래된 상태로 방치됩니다. bun-docs-toolkit은 다른 접근 방식을 사용합니다: 완전한 Bun 문서를 포함하고 이미 설치된 Bun 버전에 고정된 bun-types npm 패키지에서 문서를 읽어옵니다.

Related MCP server: MCP Bun Server

포함 내용

1. MCP Server (bun-docs-mcp)

프로젝트에 설치된 bun-types에서 문서를 해석하는 Model Context Protocol 서버입니다.

설정 — MCP 구성에 추가:

{
  "mcpServers": {
    "bun-docs": {
      "command": "bunx",
      "args": ["bun-docs-mcp"]
    }
  }
}

도구:

• search_bun_docs({ query, category? }) — 일반 영어 쿼리로 문서 검색

• get_bun_doc({ slug }) — 특정 문서의 전체 내용 가져오기

• list_bun_doc_categories() — 카테고리 트리 탐색

2. Agent Skills Bundle (skills/)

주제별로 그룹화된 사전 생성 SKILL.md 파일(~25개 스킬)로, skills-cli와 호환됩니다:

bunx skills add <owner>/bun-docs-toolkit

스킬은 최신 bun-types 릴리스를 추적하기 위해 CI에서 매주 재생성됩니다.

개발

# Install dependencies
bun install

# Run tests
bun test

# Regenerate skills
bun run generate:skills

작동 방식

1. packages/core — 공유 파싱: bun-types 문서 디렉터리를 확인하고, .md/.mdx 파일을 순회하며, YAML frontmatter를 파싱하고, Mintlify JSX 컴포넌트를 일반 마크다운으로 평탄화하며, 검색 가능한 인덱스를 구축합니다.

2. packages/mcp-server — 핵심 라이브러리를 사용하는 MCP 서버입니다. 런타임에 호출 프로젝트의 bun-types에서 읽어오며, 번들된 스냅샷으로 폴백합니다.

3. packages/skills-generator — 문서를 ~25개 스킬 카테고리로 그룹화하고 SKILL.md 파일을 생성하는 빌드 스크립트입니다.

라이선스

MIT — LICENSE 참조.

문서 콘텐츠는 bun-types에서 가져왔습니다 (MIT, © Jarred Sumner and Bun contributors).