Shebang Sherpa Mcp

io.github.mrfentmen由 GitHub 账号 mrfentmen 发布v1.0.0更新于 Nov 5, 2026

Aggregate local script portability risks without exposing script text or project names. Tools...

已验证STDIO仅桌面文件与存储开发者工具

概览

AI 生成的概览

本地 MCP 服务器，用于审计项目脚本的可移植性风险，仅返回汇总的解释器与权限发现。

可以做什么
  • 在不执行任何内容的情况下检查本地项目的脚本可移植性
  • 报告解释器类别汇总、可执行位覆盖情况与粗略的可移植性警告
  • 标记机器专属或绝对路径解释器、旧式解释器名称、无 shebang 的可执行文件以及缺少可执行位的脚本
  • 仅返回汇总信息，不包含路径、脚本内容、项目名、依赖名、命令参数与环境变量值
适用场景
当脚本在一台机器上正常、在另一台机器上却莫名失败时，可在共享或部署项目前做一次快速且保护隐私的解释器路径与可执行位检查。
运行要求
以本地 stdio 进程运行，从 npm 包安装；构建和运行需要 Node.js。待扫描项目由环境变量 SHEBANG_SHERPA_ROOT 限定。未声明任何认证或 API 密钥。
安装前请注意
设计上只读：不执行脚本、shell、包管理器或钩子，并跳过 Git 元数据、依赖目录、构建产物与缓存。它只是启发式检查，并非 shell 解析器或安全扫描器，发现结果需自行核实。请仅将 SHEBANG_SHERPA_ROOT 指向你打算审计的目录。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Shebang Sherpa Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

shebang-sherpa-mcp

Shebang Sherpa is a local portability audit for scripts that work on one laptop and mysteriously fail on another. It scans bounded script candidates and reports aggregate interpreter categories, executable-bit coverage, and coarse portability warnings.

Tool

  • inspect_script_portability: scan a local project without executing scripts.

The result can flag machine-specific interpreter paths, legacy interpreter names, absolute system interpreters, executable files without shebangs, and scripts missing the executable bit. It never returns paths, script text, project names, dependency names, command arguments, or environment values.

Safety

  • Reads files only. It never executes a script, shell, package manager, hook, or launcher.
  • Skips Git metadata, dependency folders, build output, coverage, and common caches.
  • Uses a bounded file count and file size.
  • Confines the project to SHEBANG_SHERPA_ROOT.
  • This is a portability heuristic, not a shell parser or security scanner.

Run

bash
npm installnpm run buildnode dist/index.js

来源：README.md，提交 0ba9d0f

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 22, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。