MCP Bun服务器
](https://bun.sh/) ](https://nodejs.org/) ](https://www.npmjs.com/package/mcp-bun)
针对Bun JavaScript运行时优化的全面模型上下文协议（MCP）服务器实现。该服务器为AI助手提供了强大的工具，可以使用Bun的高性能运行时执行、优化和管理JavaScript/TypeScript项目。
🔄 运行时兼容性：服务器要求在MCP服务器将运行的环境中安装bun（Windows本机、Windows WSL2等）。请参阅下面的更多安装细节。
特性
🚀 Bun优化执行
- 快速脚本执行：使用Bun优化的运行时运行JavaScript/TypeScript文件
- 内置TypeScript支持：直接执行TypeScript，无需编译
- 内存优化：使用
--smol内存受限环境的标志 - 热重新加载：开发服务器
--hot旗帜支持
🔧 开发工具
- 包管理：安装依赖项
bun install - 脚本运行程序：使用以下命令执行package.json脚本
bun run - 构建系统：优化项目
bun build包括缩小和捆绑 - 测试运行器：快速测试
bun test以及覆盖范围报告
📊 性能分析
- 项目分析：分析包大小、依赖关系和运行时性能
- 基准测试：比较不同优化标志的脚本性能
- 优化建议：获取Bun特定优化的建议
🖥️ 服务器管理
- 后台服务器：启动和管理长时间运行的Bun/Node.js服务器
- 过程监控：跟踪服务器状态、日志和性能
- 热重新加载服务器：具有文件监视功能的开发服务器
🔍 资源发现
- 脚本列表：浏览可用的npm/package.json脚本
- 项目结构：了解项目依赖关系和配置
快速开始
先决条件
- 包子 v1.0.0或更高版本（推荐）
- Node.js v18.0.0或更高版本（为了兼容性）
对于MacOS/Linux用户，请按照 Bun网站.
对于Windows，安装取决于您是否使用WSL2开发：
- 对于本机Windows开发，请使用 Windows安装程序.
- 如果使用WSL2进行开发，请使用以下命令在WSL2环境中安装Bun Linux安装说明.
配置
VSCode MCP客户端
为了快速安装，请使用下面的一键安装按钮之一。..
或者使用下面的配置。
如果全局使用，请在MCP客户端配置中添加以下内容 settings.json:
{
...
"mcp": {
"servers": {
"bun": {
"command": "bunx",
"args": ["-y", "mcp-bun@latest"],
"env": {
"DISABLE_NOTIFICATIONS": "true"
}
}
}
}
}在Windows上， 使用WSL2时，这无法正常工作 如果您的项目位于WSL2文件系统中，并且您在Windows上本机运行VSCode。这是因为MCP服务器在Windows上运行，Bun命令在WSL2环境中执行，这可能会导致路径问题。
在这种情况下， 在项目工作区配置中配置MCP服务器 该文件使MCP服务器在WSL2环境中运行并在那里执行Bun命令。
创建一个名为的文件 .vscode/mcp.json 在项目根目录中包含以下内容：
{
"servers": {
"bun": {
"command": "bunx",
"args": ["-y", "mcp-bun@latest"],
"env": {
"DISABLE_NOTIFICATIONS": "true"
}
}在克劳德桌面上
使用以下配置您的Claude Desktop MCP客户端：
{
"mcpServers": {
"bun": {
"command": "bunx",
"args": ["-y", "mcp-bun@latest"],
"env": {
"DISABLE_NOTIFICATIONS": "true", // Optional: disable permission prompts
}
}
}
}用于开发/本地安装
将存储库克隆到本地计算机，安装依赖项，然后构建项目：
git clone https://github.com/carlosedp/mcp-bun.git
cd mcp-bun
bun install
bun run build然后配置您的MCP客户端以使用本地构建：
{
"servers": {
"bun-dev": {
"command": "bun",
"args": ["/home/user/mcp-bun/dist/mcp-bun.js"],
"env": {
"DISABLE_NOTIFICATIONS": "true"
}
},
}
}对于测试，还有MCP检查器可用，它允许您使用Bun运行服务器并检查正在执行的命令：
bun run dev可用工具
核心执行工具
run-bun-script-file
使用Bun运行时优化执行JavaScript/TypeScript文件。
参数：
scriptPath：脚本文件的路径bunArgs：可选的Bun标志（例如。，--smol,--hot)args：要传递给脚本的参数stdin：可选标准输入cwd：工作目录timeout：执行超时
run-bun-eval
使用Bun-eval直接执行JavaScript/TypeScript代码。
参数：
code：要执行的代码evalDirectory：执行目录bunArgs：Bun优化标志stdin：标准输入timeout：执行超时
包管理
run-bun-install
使用Bun的快速包管理器安装依赖项。
参数：
packageDir：包含package.json的目录dependency：要安装的特定软件包（可选）
run-bun-script
使用Bun执行npm脚本。
参数：
packageDir：包含package.json的目录scriptName：要运行的脚本名称args：其他论点
构建与优化
run-bun-build
与Bun的bundler一起构建和优化项目。
参数：
entryPoint：要构建的条目文件outDir：输出目录target：构建目标(browser,bun,node)minify：启用缩小sourcemap：生成源映射splitting：启用代码拆分
run-bun-test
使用Bun的快速测试运行器执行测试。
参数：
testPath：测试文件或目录coverage：启用代码覆盖率watch：启用监视模式bail：N次故障后停止timeout：测试超时
性能分析
analyze-bun-performance
全面的项目绩效分析。
参数：
projectDir：项目目录entryPoint：分析入口点options：分析选项（捆绑包、依赖关系、运行时）
benchmark-bun-script
使用不同的优化标志对脚本性能进行基准测试。
参数：
scriptPath：用于基准测试的脚本iterations：试运行次数warmup：热身跑
服务器管理
start-bun-server
启动具有热重新加载和监视功能的优化Bun服务器。
参数：
scriptPath：服务器脚本路径cwd：工作目录bunArgs：布恩旗optimizations：热重新加载、观看、smol模式选项
其他服务器工具
start-node-server：启动Node.js服务器以实现兼容性list-servers：列出所有正在运行的服务器及其状态和日志stop-server：停止优雅或强制运行服务器get-server-logs：使用筛选选项检索服务器日志
版本管理
get-bun-version
获取当前Bun版本和修订信息。
list-bun-versions
列出可用的Bun安装。
select-bun-version
选择要执行的特定Bun版本。
性能优化提示
内存优化
使用 --smol 内存受限环境的标志：
bun --smol your-script.js安全考虑
- 服务器在执行任何命令之前都会提示用户获取权限
- 脚本以与MCP服务器进程相同的权限运行
- 使用环境变量
DISABLE_NOTIFICATIONS=true自动化 - 从不受信任的来源运行脚本时要小心
发展
建筑
bun run build # Build with Bun
bun run build:node # Build with Node.js/TypeScript开发模式
bun run dev # Run with Bun + MCP Inspector
bun run dev:node # Run with Node.js + MCP Inspector掉毛
bun run lint # Check for issues
bun run lint:fix # Fix auto-fixable issues贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用，添加测试
- 提交拉取请求
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。