ag-bash

@ag-bash/mcp-server

Claude Desktop やその他の MCP ホストに 70 個の ag-bash ツールを提供する MCP サーバー

AI エージェントに永続的なサンドボックス化 Bash 環境を提供し、stdio 経由で 70 個のツールを公開するスタンドアロンの Model Context Protocol（MCP）サーバーです。

インストール

次の 1 行で 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.modelcontextprotocol.io に io.github.sairam0424/ag-bash（アクティブ）として登録されています。

こちらでも利用できます： Homebrew（ag-bash-mcp バイナリ） · 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 — CWD、環境変数、定義済み関数を確認します
• エージェント機能一式 — 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 スキーマで検証します

特長

• レート制限 — セッションごとに 1 分あたり 60 リクエスト（設定可能）
• 読み取り専用のルート — プロジェクトファイルはオーバーレイとしてマウントされ、書き込みはメモリ内に保持されます
• サニタイズされたエラー — JSON-RPC レスポンスからファイルパスを除去し、長さを 200 文字に制限します
• コンソールへの情報漏えいゼロ — すべての診断情報を構造化ハンドラー経由で処理します
• リソース制限 — 無限ループや過剰なメモリ使用を防ぎます
• オーケストレーションのガバナンス — エージェントのネスト制限により再帰ループを防ぎます

v4.1 アップグレードに関する注意事項

変更前（v3.x）	変更後（v4.1）
6 個のツール	40 個以上のツール
基本的な Bash 実行	セマンティックなコードインテリジェンスを備えたエージェント機能一式
手動での状態管理	呼び出し間で環境を保持

リンク

• GitHub リポジトリ
• コアエンジン
• MCP レジストリ — io.github.sairam0424/ag-bash

ライセンス

Apache-2.0