ag-bash

@ag-bash/mcp-server

将 70 个 ag-bash 工具提供给 Claude Desktop 和其他 MCP 宿主的 MCP 服务

一款独立的模型上下文协议（MCP）服务，为 AI Agent 提供持久化、沙盒隔离的 Bash 环境，并通过标准输入/输出提供 70 个工具。

安装

一行命令即可将服务添加到 Claude Code：

claude mcp add ag-bash -- npx -y @ag-bash/mcp-server

也可以全局安装：

npm install -g @ag-bash/mcp-server

Claude Code 插件

通过可自托管的市场安装：

/plugin marketplace add sairam0424/ag-bash
/plugin install ag-bash@ag-bash

MCP Registry

已在 registry.modelcontextprotocol.io 中列为 io.github.sairam0424/ag-bash（有效）。

也可通过以下方式使用： Homebrew（ag-bash-mcp bin）· Docker MCP Catalog（审核中）

brew tap sairam0424/tap && brew install ag-bash

用法

直接运行服务：

npx ag-bash-mcp

Claude Desktop

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "ag-bash": {
      "command": "ag-bash-mcp",
      "args": []
    }
  }
}

Cursor / VS Code

在 IDE 设置中添加新的 MCP 服务：

• 名称：ag-bash
• 类型：command
• 命令：ag-bash-mcp

提供的功能

• run_bash — 使用完整的 Unix 工具集（jq、grep、sed、awk 等）执行脚本
• get_state — 检查当前工作目录、环境变量和已定义的函数
• Agent 能力套件 — ag-edit、ag-diff、ag-hover、ag-explain、ag-find-symbol、ag-todo、ag-analyze、ag-snapshot、ag-plan、ag-notebook、ag-mcp
• 总计 70 个工具，通过 JSON-RPC 2.0 提供，每项输入均使用 Zod schema 进行验证

功能特性

• 速率限制 — 每个会话每分钟 60 次请求（可配置）
• 只读根目录 — 项目文件以 overlay 方式挂载；写入内容保存在内存中
• 错误信息清理 — JSON-RPC 响应会移除文件路径，并限制在 200 个字符以内
• 零控制台信息泄漏 — 所有诊断信息均通过结构化处理程序传递
• 资源限制 — 防止无限循环和内存过度占用
• 编排治理 — Agent 嵌套限制可防止递归循环

v4.1 升级说明

之前（v3.x）	之后（v4.1）
6 个工具	40+ 个工具
基础 Bash 执行	完整的 Agent 能力套件，支持语义代码智能
手动管理状态	跨调用持久化环境

链接

• GitHub 仓库
• 核心引擎
• MCP Registry — io.github.sairam0424/ag-bash

许可证

Apache-2.0