bun-docs-toolkit

面向 AI 代理的始终最新的 Bun 文档——直接来源于 bun-types，因此它与你项目所使用的 Bun 版本精确绑定。

为什么？

每个现有的"面向 AI 代理的 Bun 文档"项目都会在某个时间点 fork 或克隆 Bun 的文档，然后逐渐过时。bun-docs-toolkit 采用了不同的方法：它从 bun-types npm 包中读取文档，该包随附完整的 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 frontmatter，将 Mintlify JSX 组件扁平化为纯 markdown，并构建可搜索的索引。

2. packages/mcp-server — 使用核心库的 MCP 服务器。在运行时从调用项目的 bun-types 读取，回退到捆绑的快照。

3. packages/skills-generator — 构建脚本，将文档分组为约 25 个技能类别并生成 SKILL.md 文件。

许可证

MIT — 参见 LICENSE。

文档内容来源于 bun-types（MIT，© Jarred Sumner 和 Bun 贡献者）。