bun-docs-toolkit

Всегда актуальная документация Bun для ИИ-агентов — берётся напрямую из bun-types, поэтому она привязана к версии того Bun, который использует ваш проект.

Зачем?

Каждый существующий проект «Bun docs for AI agents» делает форк или клонирует документацию Bun в определённый момент времени, а затем устаревает. bun-docs-toolkit использует другой подход: он читает документацию из npm-пакета bun-types, который поставляется с полной документацией Bun и уже привязан к версии установленного у вас Bun.

Related MCP server: MCP Bun Server

Что включено

1. MCP-сервер (bun-docs-mcp)

Сервер Model Context Protocol, который читает документацию из того bun-types, который установлен в вашем проекте.

Настройка — добавьте в вашу MCP-конфигурацию:

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

Инструменты:

• search_bun_docs({ query, category? }) — поиск по документации по запросу на обычном английском

• get_bun_doc({ slug }) — получить полное содержимое конкретного документа

• list_bun_doc_categories() — просмотр дерева категорий

2. Набор навыков для агентов (skills/)

Предварительно сгенерированные файлы SKILL.md, сгруппированные по темам (~25 навыков), совместимые с skills-cli:

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

Навыки перегенерируются еженедельно через CI, чтобы отслеживать последний релиз bun-types.

Разработка

# Install dependencies
bun install

# Run tests
bun test

# Regenerate skills
bun run generate:skills

Как это работает

1. packages/core — Общий парсинг: определяет каталог документации bun-types, обходит файлы .md/.mdx, разбирает YAML-фронтматтер, преобразует JSX-компоненты Mintlify в обычный markdown и строит поисковый индекс.

2. packages/mcp-server — MCP-сервер, использующий библиотеку ядра. Читает bun-types вызывающего проекта во время выполнения, с откатом к встроенному снимку.

3. packages/skills-generator — Сборочный скрипт, который группирует документацию в ~25 категорий навыков и создаёт файлы SKILL.md.

Лицензия

MIT — см. LICENSE.

Содержимое документации взято из bun-types (MIT, © Jarred Sumner и участники Bun).