@ag-bash/mcp-server
v6.0.4
Published
Standalone Model Context Protocol (MCP) server for Ag-Bash — a sandboxed bash environment with 70 agentic tools (run_bash, semantic code edit/diff/analyze, WASM Python/JS, task & worktree management) over stdio JSON-RPC.
Maintainers
Readme
@ag-bash/mcp-server
MCP server exposing 40+ ag-bash tools to Claude Desktop and other MCP hosts
A standalone Model Context Protocol (MCP) server that gives AI agents a persistent, sandboxed Bash environment. Previously 6 tools in v3.x, now 40+ tools in v4.1.
Installation
npm install -g @ag-bash/mcp-serverUsage
Run the server directly:
npx ag-bash-mcpClaude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"ag-bash": {
"command": "ag-bash-mcp",
"args": []
}
}
}Cursor / VS Code
Add a new MCP server in your IDE settings:
- Name:
ag-bash - Type:
command - Command:
ag-bash-mcp
What's Exposed
run_bash— Execute scripts with full unix toolkit (jq,grep,sed,awk, etc.)get_state— Inspect CWD, environment variables, and defined functions- Agentic suite —
ag-edit,ag-diff,ag-hover,ag-explain,ag-find-symbol,ag-todo,ag-analyze,ag-snapshot,ag-plan,ag-notebook,ag-mcp - 40+ tools total via JSON-RPC 2.0 with Zod schema validation on every input
Features
- Rate limiting — 60 requests/minute per session (configurable)
- Read-only root — Project files mounted as overlay; writes stay in memory
- Sanitized errors — JSON-RPC responses strip file paths, capped at 200 chars
- Zero console leakage — All diagnostics flow through structured handlers
- Resource limits — Protection against infinite loops and excessive memory
- Orchestration governance — Agent nesting limits prevent recursive loops
v4.1 Upgrade Notes
| Before (v3.x) | After (v4.1) | |---|---| | 6 tools | 40+ tools | | Basic bash execution | Full agentic suite with semantic code intelligence | | Manual state management | Persistent environment across calls |
Links
License
Apache-2.0
