mcpField
S
shellquote-mcp

shellquote-mcp

ローカル
github.com/MukundaKatta開発ツール020 週間前に更新
リポジトリ

shellquote-mcp について

shellquote-mcpは、bash、cmd.exe、PowerShell向けにシェル引数をエスケープするMCPサーバーです。コマンド生成時に引数の文字列を保ちたいエージェントや開発者向けです。

主な機能

  1. 01bash、sh、zsh向けに引数を引用
  2. 02bash引数リストをエスケープして連結
  3. 03cmd.exe向けに引数を引用
  4. 04PowerShell文字列を引用

活用シーン

  1. 01空白を含む引数を安全に渡す
  2. 02ドル記号やバックスラッシュをそのまま保持
  3. 03bash内のシングルクォートを処理
  4. 04Windowsシェル向けの引数を準備

MCP 対応

MCPクライアントに、bash、cmd.exe、PowerShell引数用のシェル引用ツールを提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "mukundakatta-shellquote": {
      "command": "npx",
      "args": [
        "-y",
        "@mukundakatta/shellquote-mcp"
      ]
    }
  }
}
起動コマンドnpx -y @mukundakatta/shellquote-mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@mukundakatta/shellquote-mcp0.1.0

ツール

4

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
argstringはい

詳細

@mukundakatta/shellquote-mcp

シェル引数を安全にエスケープする MCP サーバーです。引用符、スペース、$VAR の展開、バックスラッシュが原因で、LLM が生成したシェルコマンドが失敗したり、さらに悪い事態になったりするのを防ぎます。

ツール

  • quote_bash(arg) — bash/sh/zsh 用のシングルクォートエスケープです。すべてのメタ文字の展開を抑止します。
  • quote_bash_argv(args) — リストをエスケープし、スペースで結合します。
  • quote_cmd(arg) — Windows cmd.exe 用です（注意：cmd には回避できない遅延展開の問題があります）。
  • quote_powershell(arg) — シングルクォートで囲んだ PS 文字列です。

このツールが必要な理由

LLM はシェルのエスケープを頻繁に間違えます。

  • bash -c "echo $HOME" は、変数をそのまま渡すのではなく展開します
  • cmd /c "del file.txt" は、ファイル名にスペースが含まれていると失敗します
  • bash でシングルクォートを埋め込むには、LLM が忘れがちな厄介な '\'' の処理が必要です

このツールは、メタ文字による予期しない動作を起こすことなく、シェルがそのまま受け付ける文字列を返します。

インストール — Claude Desktop

{
  "mcpServers": {
    "shellquote": { "command": "npx", "args": ["-y", "@mukundakatta/shellquote-mcp"] }
  }
}

Cursor / Cline / Windsurf / Zed でも同じ形式です。

ライセンス

MIT OR Apache-2.0.

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。