MCP-邦宁

Name: MCP-邦宁
Author: carlosedp

作者：carlosedp8 星标更新：2025-07-09

安装使用来源：spider==github.com

项目介绍

MCP Bun Server

一个全面优化的 Model Context Protocol (MCP) 服务器实现，专为 Bun JavaScript 运行时设计。该服务器为AI助手提供了强大的工具，可以使用Bun的高性能运行时来执行、优化和管理JavaScript/TypeScript项目。

🔄 运行时兼容性：服务器需要在运行MCP服务器的环境中安装bun（如Windows原生、Windows WSL2等）。更多安装详情见下文。

示例用法

功能

🚀 优化的Bun执行

快速脚本执行：使用Bun的优化运行时运行JavaScript/TypeScript文件
内置TypeScript支持：直接执行TypeScript，无需编译
内存优化：使用--smol标志以适应内存受限环境
热重载：开发服务器支持--hot标志

🔧 开发工具

包管理：使用bun install安装依赖
脚本运行器：使用bun run执行package.json中的脚本
构建系统：使用bun build优化项目，包括最小化和打包
测试运行器：使用bun test进行快速测试并生成覆盖率报告

📊 性能分析

项目分析：分析捆绑大小、依赖项和运行时性能
基准测试：比较不同优化标志下的脚本性能
优化建议：获取针对Bun的具体优化建议

🖥️ 服务器管理

后台服务器：启动和管理长时间运行的Bun/Node.js服务器
进程监控：跟踪服务器状态、日志和性能
热重载服务器：具有文件监视能力的开发服务器

🔍 资源发现

脚本列表：浏览可用的npm/package.json脚本
项目结构：理解项目依赖关系和配置

快速开始

先决条件

Bun v1.0.0或更高版本（推荐）
Node.js v1.8.0或更高版本（用于兼容性）

对于MacOS/Linux用户，请按照Bun网站上的说明安装Bun。

对于Windows用户，安装取决于是否使用WSL2开发：

对于原生Windows开发，请使用Windows安装程序安装Bun。
如果使用WSL2开发，请根据Linux安装说明在WSL2环境中安装Bun。

配置

在VSCode MCP客户端上

为了快速安装，请使用以下一键安装按钮之一...

或者使用以下配置。

如果全局使用，请在settings.json中的MCP客户端配置中添加以下内容：

{
  ...
  "mcp": {
    "servers": {
      "bun": {
        "command": "bunx",
        "args": ["-y", "mcp-bun@latest"],
        "env": {
          "DISABLE_NOTIFICATIONS": "true"
        }
      }
    }
  }
}

在Windows上，如果项目位于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上

配置您的Claude Desktop MCP客户端，如下所示：

{
  "mcpServers": {
    "bun": {
      "command": "bunx",
      "args": ["-y", "mcp-bun@latest"],
      "env": {
        "DISABLE_NOTIFICATIONS": "true",  // 可选：禁用权限提示
      }
    }
  }
}

本地开发/安装

将仓库克隆到本地机器，安装依赖并构建项目：

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 Inspector可用，它允许您使用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的打包器构建和优化项目。

参数：

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：Bun标志
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        # 使用Bun构建
bun run build:node   # 使用Node.js/TypeScript构建

开发模式

bun run dev          # 使用Bun + MCP Inspector运行
bun run dev:node     # 使用Node.js + MCP Inspector运行

代码检查

bun run lint         # 检查问题
bun run lint:fix     # 自动修复可修复的问题

贡献

分叉仓库
创建功能分支
进行更改
如适用，添加测试
提交拉取请求

许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。

致谢

基于Model Context Protocol
优化了Bun运行时
大量灵感来自MCP Node.js服务器