安全bash执行服务

一个基于just-bash的安全、隔离的文件系统和bash MCP服务器,允许AI助手和工具在沙箱环境中安全执行bash命令,并提供可配置的超时和资源限制。

  • by guillaumemaka
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 guillaumemaka/just-bash-mcp

使用说明

只需抨击mcp

一个安全、隔离的文件系统和bash MCP(模型上下文协议)服务器,由 只是bash该服务器使AI助手和工具能够在具有可配置超时和资源限制的沙盒环境中安全地执行bash命令。

特性

  • 沙盒执行:命令仅使用bash在隔离环境中运行
  • MCP协议:完全符合模型上下文协议规范
  • 可配置超时:为长时间运行的命令设置自定义超时值
  • 缺省巩固安全:最小权限和隔离的文件系统访问
  • 轻松集成:适用于任何兼容MCP的客户端,包括Claude Desktop、VS Code等

安装

bun install

Laminar的可观测性

该项目支持 层流 用于跟踪和可观察性。要启用层流跟踪,请执行以下操作:

  1. 从获取API密钥 层流
  2. 设置 LMNR_PROJECT_API_KEY 环境变量:
export LMNR_PROJECT_API_KEY=your-api-key

当MCP服务器处理工具调用时,Laminar将自动捕获跟踪。

用法

发展模式

运行MCP客户端以测试服务器:

bun run dev

建筑

将TypeScript构建为JavaScript:

bun run build

包裹

创建可分发包:

bun run package

VS代码MCP安装

将服务器安装为VS Code MCP工具:

bun run vscode:mcp:install

测试

运行测试:

bun test

MCP工具

execute_bash

在隔离的沙盒环境中执行bash命令。

参数:

  • command (string,必填):要执行的bash命令
  • timeout (数字,可选):超时时间(毫秒)(默认值:30000)

例子:

{
  "name": "execute_bash",
  "arguments": {
    "command": "ls -la",
    "timeout": 5000
  }
}

许可证

MIT许可证-请参阅 许可证 了解详情。