文档搜索扩展

Zed的Bun Docs MCP

使用模型上下文协议（MCP）直接在Zed中搜索Bun文档。

[！重要] Zed开始支持远程MCP服务器 https://github.com/zed-industries/zed/pull/39021，在Zed发布 v0.214.5.
如果您在使用此扩展时遇到问题，请提交问题，并使用 官方远程服务器直接：

复制

{
  "context_servers": {
    "bun-docs": {
      "url": "https://bun.com/docs/mcp",
      "enabled": true,
      "headers": {},
    },
  },
}

不幸的是，扩展作者（目前）还不可能提供自定义 扩展清单中的服务器URL。

特性

• 🔍 搜索Bun文档 -从Zed Assistant查询Bun文档
• ⚡ 纯锈 -从GitHub版本自动下载的原生二进制文件

安装

Zed扩展（即将推出）

1. 打开Zed
2. 命令+移动+十、 （macOS）或
   控制键+移动+十、 （Linux/Windows）
   → Extensions
3. 搜索：“Bun Docs MCP”
4. 单击安装

As Dev扩展（本地发展）

# Clone this repository
git clone https://github.com/kjanat/bun-docs-mcp-zed
cd bun-docs-mcp-zed

然后，在Zed中安装：

• 按 命令+移动+P （macOS）或
  控制键+移动+P （Linux/Windows）
• 类型：“zed:安装开发扩展”
• 选择此目录

无需构建！ 扩展程序会自动从GitHub下载Rust二进制文件 首次使用时发布。

用法

1. 打开助手:
   命令+移动+A. （macOS）或
   控制键+移动+A. （Linux/Windows）
2. 启用上下文：单击上下文下拉列表→ 启用“bun-docs mcp”
3. 提出问题：“Bun.serve是如何工作的？”

查询示例

• 怎么 Bun.serve 工作？
• 解释Bun的 WebSocket 支持
• Bun的TCP API是什么？
• 如何使用 Bun.file?
• 给我看 Bun.spawn 示例

建筑

flowchart TD
    A["🔧 Zed Extension (WASM)<br/>• Auto-downloads binary<br/>• Platform detection<br/>• Daily update checks<br/>• Size: 171 KB"]
    B["📦 GitHub Releases<br/>kjanat/bun-docs-mcp-proxy<br/>• 6 platforms supported<br/>• ~1.3 MB compressed"]
    C["⚙️ Rust MCP Proxy (Native)<br/>• stdio ↔ HTTP ↔ SSE<br/>• 2.7 MB extracted<br/>• 4ms startup"]
    D["🌐 Bun Docs API<br/>https://bun.com/docs/mcp"]

    A -->|"downloads from"| B
    B -->|"extracts to /work/"| C
    C -->|"queries"| D

运作原理

1. 扩展：Zed从该仓库加载WASM扩展
2. 自动下载：首次使用时，从下载特定于平台的二进制文件 GitHub发布
3. 代理二进制文件：Rust二进制转换为：
   • Zed的标准输入/标准输出（JSON-RPC）
   • Bun-Docs HTTP API（SSE响应）
4. 搜索：查询Bun文档并返回结果

支持的平台

自动检测并支持所有平台：

静态Linux构建（musl）也可用。

发展

项目结构

bun-docs-mcp-zed/
├── extension.toml      # Zed extension metadata
├── Cargo.toml          # Rust build configuration
├── src/
│   └── lib.rs          # Extension (auto-downloads proxy binary)
├── ARCHITECTURE.md     # Technical architecture
└── README.md           # This file

代理实现：单独回购 kjanat/bun文档mcp代理

建筑

# Build extension WASM
cargo build --release --lib

# Extension auto-downloads proxy binary from GitHub
# No need to build proxy locally!

测试

# Install as dev extension in Zed
# Cmd+Shift+P (macOS) or Ctrl+Shift+P (Linux/Windows) → "zed: install dev extension"
# Select this directory

# Enable in Assistant and test
# Open Assistant → Enable "bun-docs-mcp"
# Ask: "How does Bun.serve work?"

技术细节

MCP协议：JSON-RPC 2.0通过标准输入
运输：服务器通过HTTPS发送事件（SSE）
API端点: https://bun.com/docs/mcp
二进制源：自动下载自 GitHub发布

有关详细的体系结构信息，请参见 建筑.md.

故障排除

扩展无法启用

检查Zed日志:
命令+移动+P （macOS）或
控制键+移动+P （Linux/Windows）
→ “zed：打开日志”

常见问题:

• 首次使用需要2-3秒（下载二进制文件）
• 网络问题阻止下载→ 检查互联网连接
• 二进制文件不适用于您的平台→ 检查上面支持的平台

已下载二进制文件，但无法运行

查找二进制位置:

该扩展将二进制文件存储在Zed的扩展工作目录中。确切的 路径因平台而异：

• Linux: ~/.local/share/zed/extensions/work/bun-docs-mcp/bun-docs-mcp-proxy/
• macOS: ~/Library/Application Support/Zed/extensions/work/bun-docs-mcp/bun-docs-mcp-proxy/
• 视窗: %APPDATA%\Zed\extensions\work\bun-docs-mcp\bun-docs-mcp-proxy\

验证二进制文件是否存在 （Linux/macOS）：

ls -lh ~/.local/share/zed/extensions/work/bun-docs-mcp/bun-docs-mcp-proxy/
# Should show: bun-docs-mcp-proxy (executable)

手动测试 （Linux/macOS）：

~/.local/share/zed/extensions/work/bun-docs-mcp/bun-docs-mcp-proxy/bun-docs-mcp-proxy <<< '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# Should return: {"jsonrpc":"2.0","id":1,"result":{"tools":[...]}}

备注：从上方将路径替换为您的平台特定位置。

为什么是Rust？

• 无聊：为什么不呢。..

看 建筑.md 了解迁移历史和技术细节。

贡献

欢迎投稿！

代理实现: kjanat/bun文档mcp代理
扩展：此存储库

许可证

麻省理工学院

学分

• Zed编辑 -可扩展代码编辑器
• 包子 -快速JavaScript运行时
• 模型上下文协议 -LLM集成标准
• Bun Docs MCP服务器 -官方Bun文档API

准备好在Zed中搜索Bun文档！ 安装扩展并开始询问 问题。 🚀