Zsh Tool

MCP开发工具

提供方 ArkTechNWA

开发工具 未标注 无需鉴权 社区 / 第三方 Claude

专为Claude Code设计的ZSH执行工具,提供Bash兼容性、基于yield的监督、PTY模式、NEVERHANG断路器及A.L.A.N.短期学习功能。

一句话选型结论

按资料字段整理

Zsh Tool 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 4 仓库热度,无公开仓库时显示未标注
工具数 10 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量10暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

shell工具Rust本地部署命令执行交互式终端开发辅助性能优化

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 10 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 10 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zsh Tool当前 10 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ArkTechNWA上游标注的维护方 ArkTechNWA
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

18.5 KB
来自项目仓库与上游目录的原文,未做删改

zsh工具

用于Claude Code的Zsh执行工具,具有完整的Bash奇偶校验、基于产量的监督、PTY模式、NEVERHANG断路器和A.L.A.N.短期学习。

状态: 贝塔系数(v0.7.2)

作者 克劳德+梅尔德雷

许可证: 麻省理工学院

组织机构: ArkTechNWA


对可靠性的执着关注。


为什么?

#1原因: 如果你使用zsh,Claude Code的Bash工具会导致引号不匹配和shell混淆。每个调试循环都需要消耗令牌。zsh工具立即永久消除了这种情况。

令牌数学: 避免了一次调试螺旋=节省了30多秒,保留了数百个令牌。

zsh工具是 智能shell执行:

问题 zsh工具解决方案
Bash/zsh引用混淆 本地zsh --没有shell不匹配,没有调试循环
命令永远挂起 基于收益的执行 --始终夺回控制权
无法查看正在运行的命令 zsh-poll --增量输出收集
无法与提示交互 PTY模式 + zsh_send --全面的互动支持
无法键入密码 PTY模式 --让Claude Code键入自己的密码
超时级联 切勿挂断断路器 --故障快速,自动恢复
通话之间没有内存 A.L.A.N.2.0 --重试检测、条纹跟踪、主动洞察
投票会浪费代币 智能轮询 --2s监听窗口、自适应建议、持续时间估计
盲目杀人,不学习 有杀戮意识的A.L.A.N。 --将急躁与真正的宿醉进行分类
使用错误的标志重试 manopt --重复故障时的自动曲面命令选项
无任务管理 zsh任务, zsh_kill --完全控制

这就是“运行命令”和“智能shell集成”之间的区别


特性

基于收益的执行

命令返回后 yield_after 如果仍在运行,则显示部分输出的秒数:

  • 不再悬挂 --你总是能重新获得控制权
  • 增量输出 --收集与 zsh_poll
  • 交互式输入 --发送与 zsh_send
  • 任务管理 — zsh_kill 和 zsh_tasks

PTY模式

交互式程序的完整伪终端仿真:```bash

Enable with pty: true

zsh(command="pass insert mypass", pty=true)

See prompts, send input with zsh_send


- 正确处理交互式提示
- 需要TTY的程序
- 颜色输出和端子转义序列
- 完整的stdin/stdout/stderr合并

### NEVERHANG断路器

防止挂起命令阻塞会话:

- 跟踪每个命令哈希的超时模式
- 在滚动1小时窗口中3次超时后打开电路
- 5分钟后自动恢复
- 国家: `CLOSED` (正常)→ `OPEN` (封锁)→ `HALF_OPEN` (测试)

### A.L.A.N.2.0(必要时)

智能短期学习-- *“也许你搞砸了,也许你做得对。”*

- **重试检测** --重复失败的命令时发出警告
- **条纹追踪** --庆祝成功连胜,警告失败连胜
- **模糊匹配** — `git push origin feature-1` → `git push origin *`
- **主动洞察** --运行命令前的上下文反馈
- **会话记忆** --15分钟滚动窗口跟踪最近的活动
- **时间衰退** --指数衰减(24小时半衰期),自动修剪
- **SSH智能** --将主机连接与远程命令成功分离
- **管段跟踪** --何时 `cat foo · grep -badopts · sort` A.L.A.N.知道失败了 *哪个* 分段失败

#### 带行号的增量输出(v0.6.3)

`zsh_poll` 仅返回 **自上次投票以来的新输出**,前缀为全局行号。不再每次投票都会丢弃800条线路。```
801: Installing package foo...
802: Compiling module bar...
803: Done.
字段 它告诉你什么
from_line / to_line 此增量中的线范围(例如801-803)
new_bytes 自上次轮询以来新输出的字节数
full_output (param) 通过 true 获取包含行号的整个缓冲区

第一次轮询返回第1行的所有输出。后续的轮询从上次停止的地方继续。完成的任务返回最终的增量,然后在重新轮询时为空。

智能投票

zsh_poll 执行a 2秒监听窗口 在返回之前。如果输出在2秒内到达,它会立即返回。如果不是,则轮询元数据告诉代理发生了什么:

字段 它告诉你什么
polls_since_output 连续有多少个空投票
elapsed_since_last_output_s 自上次输出后的空闲时间
alan_estimate 基于命令历史的A.L.A.N.持续时间预测
suggestion 适应性建议:间隔民意调查,尽快检查,或考虑取消

建议只是建议,总是由代理人决定。2分钟 pip install 不再产生40次空往返。

杀戮意识A.L.A.N。

当代理终止一个命令时,a.L.a.N.会将其记录为 KILLED 结果和分类 为什么:

类别 含义 示例
EARLY_KILL 在平均完工时间之前就被杀死了 “30多岁时死亡。中位数为120秒。需要更多时间。”
LATE_KILL 跑步超过预期时间 “180秒后死亡。中位数为45秒。出了点问题。”
PATTERN_PROBLEM 模板在50%以上的情况下被杀死 “这种模式可能需要一种完全不同的方法。”

杀戮分类比较 kill_elapsed / median_duration 区分不耐烦和真正的宿醉。

manopt——失败的手册页选项

当命令反复失败时,a.L.a.N.会显示其可用选项:

  • 第一次失败 --正常反馈,无操纵
  • 第二次失败 --触发异步 manopt 后台查找(超时2秒)
  • 第三次+失败 --在A.L.A.N.insight中显示缓存的选项表

从本地手册页解析。缓存在SQLite中。默认情况下打开(ALAN_MANOPT_ENABLED=1).

SSH跟踪

A.L.A.N.专门处理SSH命令,记录了两个单独的观察结果:

观察 它跟踪什么 示例见解
主机连接 我们可以连接到此主机吗? “主机'vps'的连接失败率为67%”
远程命令 此命令是否跨主机工作? “远程命令‘git pull’在3台主机上可靠”

出口代码分类:

  • 0 --成功(连接AND命令成功)
  • 255 --连接失败(SSH无法连接)
  • 1-254 --命令失败(已连接但远程命令失败)

这意味着当 ssh host3 'git pull' 255出口失败,A.L.A.N.知道 主机 无法触及——不是这样的 git pull 坏了。


工具

工具 目的
zsh 在基于产量的监督下执行命令
zsh_poll 使用行号从正在运行的任务中获取新的输出(增量)
zsh_send 将输入发送到任务的stdin
zsh_kill 终止正在运行的任务
zsh_tasks 列出所有活动任务
zsh_health 总体健康状况
zsh_alan_stats A.L.A.N.数据库统计
zsh_alan_query 查询命令的模式洞察
zsh_neverhang_status 断路器状态
zsh_neverhang_reset 将电路重置为闭合

安装

来自市场(推荐)

将ArkTechNWA市场添加到Claude Code:```
ArkTechNWA/claude-plugins


然后安装: `/plugin install arktechnwa/zsh-tool`

**就这样** 该插件在首次运行时自动安装依赖项。

### 手动安装```bash
git clone https://github.com/ArkTechNWA/zsh-tool.git ~/.claude/plugins/zsh-tool

启用 ~/.claude/settings.json:```json
{
"enabledPlugins": {
"zsh-tool": true
}
}


捆绑 `scripts/run-mcp.sh` 在第一次运行时构建Rust二进制文件并启动MCP服务器。

### 本地开发

对于本地开发/测试,包装器脚本会自动检测何时 `CLAUDE_PLUGIN_ROOT` 未展开,而是使用计算出的插件根目录。无需更改配置。

或者,创建一个 `.mcp.local.json` 具有绝对路径:```json
{
"mcpServers": {
"zsh-tool": {
"type": "stdio",
"command": "/path/to/zsh-tool/scripts/run-mcp.sh",
"env": {
"NEVERHANG_TIMEOUT_DEFAULT": "120",
"NEVERHANG_TIMEOUT_MAX": "600"
}
}
}
}

这 ALAN_DB_PATH 将自动设置为 {plugin_root}/data/alan.db 如果没有明确提供。

要求: 防锈工具链(cargo)以及 zsh 必须安装。


建筑```

zsh-tool/
├── .claude-plugin/
│ ├── plugin.json
│ └── CLAUDE.md
├── .mcp.json
├── zsh-tool-rs/
│ ├── Cargo.toml
│ └── src/
│ ├── main.rs # CLI entry point
│ ├── lib.rs # Module exports
│ ├── executor.rs # Pipe/PTY command execution
│ ├── config.rs # User config (~/.config/zsh-tool/)
│ ├── circuit.rs # NEVERHANG circuit breaker
│ ├── meta.rs # Task metadata (exit code, pipestatus)
│ ├── alan/ # A.L.A.N. 2.0 learning engine
│ │ ├── mod.rs # Recording + insights
│ │ ├── hash.rs # Fuzzy command hashing
│ │ ├── insights.rs # Proactive feedback
│ │ ├── manopt.rs # Man-page option parsing
│ │ ├── ssh.rs # SSH host/command tracking
│ │ ├── streak.rs # Success/failure streaks
│ │ ├── pipeline.rs # Pipeline segment tracking
│ │ ├── prune.rs # Temporal decay + pruning
│ │ └── stats.rs # Database statistics
│ └── serve/ # MCP JSON-RPC server
│ ├── mod.rs # Request dispatch + tool handlers
│ ├── format.rs # Rich output formatting
│ ├── protocol.rs # JSON-RPC framing
│ └── tools.rs # Tool schema definitions
├── scripts/
│ └── run-mcp.sh # Build + launch wrapper
├── data/
│ └── alan.db # A.L.A.N. SQLite database
└── README.md


______________________________________________________________________

## 配置

环境变量(在.mcp.json中设置):

- `ALAN_DB_PATH` --A.L.A.N.数据库位置
- `NEVERHANG_TIMEOUT_DEFAULT` --默认超时(120秒)
- `NEVERHANG_TIMEOUT_MAX` --最长超时时间(600秒)
- `ALAN_MANOPT_ENABLED` --启用手册页选项失败提示(默认值: `1`)
- `ALAN_MANOPT_TIMEOUT` --等待manopt解析的最长秒数(默认值: `2.0`)
- `ALAN_MANOPT_FAIL_TRIGGER` --触发异步查找的失败计数(默认值: `2`)
- `ALAN_MANOPT_FAIL_PRESENT` --显示缓存选项的失败计数(默认值: `3`)

### 禁用Bash(可选)

要使用zsh作为唯一的shell,请添加 `~/.claude/settings.json`:```json
{
"permissions": {
"deny": ["Bash"]
}
}

更新日志

0.7.2

用户可见输出 — 告诉模型展示它的工作

  • 修复: 在Claude Code中,用户无法看到MCP工具的结果(平台限制)。工具描述现在指示模型在其响应文本中逐字传递命令输出。
  • 这是Claude Code不向用户呈现MCP工具结果块的一种解决方法。

0.7.1

陈旧的二进制修复 — 实际交付新格式

  • 修复: run-mcp.sh 现在运行 cargo clean -p 在源代码更改时进行重建之前,防止Cargo的增量构建提供过时的二进制文件
  • 修复: 重建触发器现在也在关注 Cargo.toml (旧版本的凸起是看不见的 find -newer 检查)

0.7.0

丰富的输出格式 — 不再有JSON转储

  • 结构化输出 --命令头、分隔部分、带图标的状态页脚
  • 视觉状态图标 — ✔ / ✘ 替换 [COMPLETED / [FAILED 括号
  • 进度巩固 --连续的进度线(例如。, 10%, 20%, 30%)折叠后仅显示最新版本,防止下载/构建过程中出现屏幕垃圾邮件
  • 命令回显 — $ command header显示运行的内容,截断为120个字符
  • 彩色出口代码 --绿色=0,红色=非零,黄色=信号(129+)
  • 更丰富的通知 --后台任务完成使用 ┌ notify: 带有故障着色
  • ALAN洞察图标 — ⚠ 对于警告, ℹ 供参考
  • 新 format.rs 模块 --从mod.rs中提取的所有格式转换为独立的、可测试的模块
  • 35项新测试 (共121个)涵盖所有格式化功能

0.6.1

协议修复 — Claude Code v2.1的JSON-RPC支持+

  • 修复: MCP服务器现在可以自动检测以换行符分隔的JSON(Claude Code v2.1.42+)与Content-Length帧
  • 调试日志记录: 用于协议协商、请求/响应生命周期、关机的stderr诊断
  • 日志文件: run-mcp.sh 将stderr重定向到 /tmp/zsh-tool-mcp.log 用于MCP调试

0.6.0

完全锈蚀重写 — 再见Python,你好速度

  • 用Rust完全重写 --MCP服务器、执行器、A.L.A.N.、NEVERHANG、所有本地
  • 79锈蚀试验 --单元测试+完整的MCP集成测试(JSON-RPC往返)
  • CI管道已重写 — cargo test + cargo clippy 替换pytest+ruff
  • Python已删除 --7600多行Python被删除,零Python依赖
  • CI速度提高约2倍 --冷造97s→ 缓存48秒(与Python的60-120秒相比)
  • 保留所有功能:yield/poll/send/kill、PTY模式、A.L.A.N.2.0、NEVERHANG、manopt、SSH跟踪、管道段

0.5.0

A.L.A.N.v2升级 — 智能投票、杀戮意识、操纵

  • 智能轮询:2s监听窗口 zsh_poll 减少空车往返;具有持续时间估计和自适应建议的民意调查元数据
  • 有杀戮意识的A.L.A.N。: KILLED 带有经过跟踪的结果类型;对早期杀死(不耐烦)、晚期杀死(真正的挂起)和模式问题(错误的方法)进行分类
  • manopt集成:在重复命令失败时异步分析手册页选项;缓存在SQLite中;同一命令模板在第三次以上失败时出现
  • 新 outcome_type 和 kill_elapsed_ms 观察专栏
  • 新 manopt_cache 持久手册页选项存储表
  • ENV变体: ALAN_MANOPT_ENABLED, ALAN_MANOPT_TIMEOUT, ALAN_MANOPT_FAIL_TRIGGER, ALAN_MANOPT_FAIL_PRESENT

0.4.90

反馈改进 — 更好的信号,更少的噪音

  • ALAN见解现在被归类为信息/警告元组
  • 命令感知:grep退出1=“不匹配”(信息),退出127=“找不到命令”(警告)
  • 执行后洞察:静默检测、管道屏蔽警告、SIGPIPE排除
  • 元数据行上的ANSI颜色(绿色=成功,红色=失败,青色=正在运行,黄色=超时)
  • 基于退出代码的完成/失败状态字
  • 原始管道清单替换格式化 [cmd:code] 字符串
  • 分组洞察显示: [info: A.L.A.N.: ...] 和 [warning: A.L.A.N.: ...]

0.4.83

Python 3.14支持 — 面向未来

  • 添加了Python 3.14分类器和徽章
  • 已删除已弃用 asyncio.DefaultEventLoopPolicy 夹具(计划在3.16中拆除)
  • 所有331个测试都通过了Python 3.14.2

0.4.81

管道状态标记泄漏修复 — 数据完整性

  • 固定比赛条件 ___ZSH_PIPESTATUS_MARKER___ 可能泄漏到输出中
  • 标记现在已剥离 _build_task_response() 在返回给来电者之前
  • 防止在执行过程中捕获输出时损坏文件内容
  • CI:Runner切换为docker executor,添加了PEP 668合规性

0.4.80

每段退出代码 — 确切地知道哪个命令失败了

  • 现在显示退出代码 [cmd1:0,cmd2:1,cmd3:0] 格式而不是单个整数
  • 每个管道段与其从zsh的实际出口状态配对 $pipestatus
  • A.L.A.N.学习获得准确的每个命令结果
  • 用于人类和人工智能分析的自记录输出
  • 修复了所有命令都报告的错误 exit=0 无论实际状态如何

0.4.79

服务器模块化重构 — 更清洁的架构

  • 将MCP服务器提取到 zsh_tool/server.py 模块
  • 集中配置 zsh_tool/config.py
  • 修复了plugin.json版本与软件包版本同步的问题

0.4.75

管道智能 — 了解管道的哪个部分出现故障

  • A.L.A.N.现在捕获了zsh的 $pipestatus 每个管道的数组
  • 每个分段都记录为独立的观测值,并有自己的退出代码
  • 当 cat foo · grep -badopts · sort 失败,你知道的 全局正则表达式打印 是问题所在吗
  • 支持引用/转义的管道解析可以正确处理复杂的命令
  • 向后兼容:完整管道仍与分段一起记录
  • 248条新测试线,涵盖分段跟踪和边缘情况

0.4.6

配置和波兰语 — 用户可配置默认值,覆盖率91%

  • 用户配置文件(~/.config/zsh-tool/config.yaml)对于自定义yield_after
  • 测试覆盖率提高:303次测试,覆盖率91%
  • 修复了任务清理中的空检查错误
  • 整合并修复徽标文件

0.4.5

捆绑插件 — 零摩擦市场安装

  • 自动安装包装器(scripts/run-mcp.sh)首次运行时创建venv
  • 便携的 .mcp.json 使用 ${CLAUDE_PLUGIN_ROOT}
  • ArkTechNWA市场支持
  • 无需手动安装pip

0.4.0

测试套件和CI — 290次测试,覆盖率89%

  • 涵盖所有模块的全面测试套件
  • 带测试和棉绒阶段的CI管道
  • 动态管道和覆盖徽章
  • 温和的测试跑步者(run_tests.sh)在文件之间睡个好觉
  • 修复了弃用警告和lint错误
  • 添加了pytest-asyncio以支持异步测试

0.3.1

SSH智能 — 将主机连接与远程命令成功分离

  • SSH命令现在记录双重观察(主机+远程命令)
  • 退出代码分类:0=成功,255=连接失败,1-254=命令失败
  • 新 ssh_observations SSH特定跟踪表
  • get_ssh_host_stats() --每台主机连接/命令成功率
  • get_ssh_command_stats() --所有主机上的每个命令统计数据
  • SSH特定见解:不稳定的主机、可靠的主机、失败的命令
  • SSH跟踪的31个新测试

0.3.0

A.L.A.N.2.0 — “也许你搞砸了,也许你做得对。”

  • 重试检测:重复失败命令时发出警告
  • 条纹追踪:庆祝成功,警告失败
  • 模糊模板匹配:相似命令分组
  • 主动洞察:执行前的情境反馈
  • 会话记忆:15分钟滚动窗口
  • 新数据库表: recent_commands, streaks

0.2.0

  • 基于收益的执行,实时监督
  • PTY模式用于全终端仿真
  • 通过以下方式提供交互式输入支持 zsh_send
  • 任务管理: zsh_poll, zsh_kill, zsh_tasks
  • 修复了子进程的stdin阻塞问题。管道

0.1.0

  • 初始版本
  • 切勿挂断断路器
  • A.L.A.N.学习数据库

许可证

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


For Johnny5. For us.
ArkTechNWA

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Zsh Tool 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Zsh Tool 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Zsh Tool 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zsh Tool 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Zsh Tool 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Zsh Tool 能提供哪些能力?

资料显示约 10 个工具;能力标签包括 Rust、Claude、开发工具。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。