mcpField
S
Shell Exec

Shell Exec

本地服务
github.com开发工具93 天前更新
代码仓库访问官网

关于 Shell Exec

Shell Exec 是用于执行 Bash 命令的 MCP 服务，适合需要让 AI 客户端运行命令或管理后台任务的开发者。它提供命令执行和后台作业状态查询。

主要功能

  1. 01执行 Bash 命令
  2. 02设置超时和后台模式
  3. 03查询后台作业状态

适用场景

  1. 01运行构建命令并查看输出
  2. 02使用命令管理文件
  3. 03启动并检查长时间运行的进程

MCP 相关

作为 MCP 服务，它向 MCP 客户端提供 `execute` 和 `get_job_status` 工具，用于执行 Bash 命令及查询后台作业。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "domdomegg-shell-exec": {
      "command": "npx",
      "args": [
        "-y",
        "shell-exec-mcp"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}
启动命令npx -y shell-exec-mcp
需要配置的环境变量
MCP_TRANSPORTTransport type.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmshell-exec-mcp1.2.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

shell-exec-mcp

用于执行 bash 命令并支持后台任务的 MCP 服务。

使用场景

运行构建命令：执行 npm run build、make 或其他构建工具并获取输出。

文件操作：使用 find、grep、mv、rm、mkdir -p、stat 等命令管理文件。

长时间运行的任务：在后台模式下启动服务或监视进程，之后再检查其状态。

系统信息：运行 df -h、ps aux、env 等命令检查系统状态。

设置

按照 install-mcp 上的说明操作，为你的 MCP 客户端（Claude Code、Claude Desktop、Cursor、Cline、VS Code 等）生成正确的配置。

工具

工具描述
execute运行 bash 命令（可选超时和后台模式）
get_job_status检查后台任务的状态

贡献

欢迎在 GitHub 上提交 Pull Request！开始贡献：

  1. 安装 Git 和 Node.js
  2. 克隆仓库
  3. 使用 npm install 安装依赖
  4. 运行 npm run test 执行测试
  5. 使用 npm run build 构建

发布

版本遵循 semantic versioning 规范。

发布步骤：

  1. 使用 npm version <major | minor | patch> 更新版本
  2. 运行 git push --follow-tags 推送并附带标签
  3. 等待 GitHub Actions 发布到 NPM 注册表。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。